dragonked2/alphacode

Free MIT AI coding agent — no API key needed. Built-in free model, or bring Claude, GPT, Gemini, DeepSeek, Ollama +50 more. Swarm mode, 40+ tools, browser & desktop automation, built in Rust.

AlphaCode – 오픈소스 Rust AI 코딩 에이전트

개요 – AlphaCode는 터미널 우선, Rust 기반 AI 에이전트로, 자연어 지시를 이해하고 코드베이스를 추론하며 파일을 편집하고 명령을 실행하며 결과를 검증할 수 있습니다. 또한 실제 Firefox 인스턴스 및 네이티브 데스크톱 애플리케이션과도 통신하여 동일한 인터페이스에서 웹 UI 및 GUI 프로그램을 자동화할 수 있습니다.


핵심 기능

기능 요청할 수 있는 작업
코드 이해 및 편집 저장소를 검사하고, 수정 계획을 세우고, 패치를 적용하고, 테스트를 추가하고, 테스트 스위트를 실행하고 diff를 보고합니다.
셸 실행 안전 프롬프트와 함께 임의의 명령, 배치 작업 또는 백그라운드 작업을 실행합니다.
웹 자동화 AlphaCode 브라우저 에이전트 Firefox 확장 프로그램을 통해 페이지 탐색, 양식 작성, 스크린샷 캡처, 파일 다운로드, UI 흐름 검증이 가능합니다.
데스크톱 자동화 OS 접근성 API(Windows의 UI Automation, macOS의 Accessibility, Linux의 AT-SPI2)를 사용하여 클릭, 입력, 스크롤, 창 읽기 등을 수행합니다.
스웜 모드 큰 목표를 독립적인 하위 작업으로 분할하여 여러 에이전트가 처리하고 결과를 집계합니다.
영구 세션 및 메모리 대화 및 프로젝트 컨텍스트를 저장하여 터미널을 닫은 후에도 작업을 재개할 수 있습니다.
모델 비종속 무료 내장 모델로 즉시 작동합니다. Claude, OpenAI, Gemini, Copilot, Cursor, Bedrock, Azure, OpenRouter 또는 OpenAI 호환 엔드포인트에 연결할 수 있습니다.
40개 이상의 내장 도구 파일 조작 (read, write, patch), 검색 (agentgrep), 실행 (bash, batch), 웹 (webfetch, httpflow), 데스크톱 (desktop, macos_computer_use), 워크플로 (plan, swarm), 유틸리티 (doctor, self_improve) 등.

일반적인 워크플로

  1. 목표 설명 – 예: "utils.rs의 실패하는 테스트를 수정하고 회귀 테스트를 추가하세요."
  2. AlphaCode가 저장소를 분석하고 계획을 세우며 호출할 도구를 결정합니다.
  3. 실행 – 파일을 편집하고 cargo test를 실행하며 UI를 확인하기 위해 Firefox를 열거나 데스크톱 앱을 클릭합니다.
  4. 검증 – 관련 테스트를 다시 실행하고 스크린샷이나 diff를 캡처하여 간결한 보고서를 생성합니다.

시작하기 (빠른 시작)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/dragonked2/alphacode/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/dragonked2/alphacode/main/scripts/install.ps1 | iex

alphacode doctor   # 환경 상태 확인
alphacode          # 대화형 UI 실행

UI 없이 단일 작업을 실행할 수도 있습니다: alphacode run "fix the failing test"

브라우저 자동화를 활성화하려면 README의 링크에서 Firefox 확장 프로그램을 설치하고 alphacode browser setup을 실행하세요.


모델 및 제공자 구성

alphacode login                     # OAuth / API 키 흐름 시작
alphacode provider list             # 구성된 제공자 확인
alphacode model use gpt-4o          # 세션에 사용할 모델 선택

내장 무료 레인은 키 없이 작동하여 첫 시도를 원활하게 합니다.


안전 조치

  • 파괴적인 파일 시스템 경로는 차단됩니다.
  • 위험한 작업은 명시적 권한 프롬프트를 트리거합니다.
  • 셸 명령은 시간 제한이 있는 샌드박스에서 실행됩니다.
  • 네트워크 호출은 SSRF 및 자격 증명 누출에 대해 스캔됩니다.
  • 세션은 영구 저장되며 충돌 후 재개할 수 있습니다.
  • 에이전트는 작고 격리된 변경을 수행하고, 테스트를 다시 실행하며, 병합 전에 구조화된 보고서를 제시하도록 지시됩니다.

AlphaCode를 사용해야 하는 경우

  • 버그 수정 / 회귀 탐색 – 에이전트가 원인을 찾고 최소 패치를 적용하고 테스트로 검증하도록 합니다.
  • 기능 추가 – 새 동작을 설명하면 AlphaCode가 코드 구조를 만들고 테스트를 추가하고 스위트를 실행합니다.
  • 웹 앱 QA – 실제 Firefox 창에서 로그인 흐름, 양식 검증 또는 스크린샷 기반 체크를 자동화합니다.
  • 데스크톱 앱 스크립팅 – 반복적인 GUI 작업(예: 계산기 열기, 계산 수행, 결과 읽기)을 자동화합니다.
  • 보안 검토 – 코드 분석, HTTP 프로빙, 브라우저 기반 테스트를 재현 가능한 워크플로로 결합합니다.
  • 대규모 프로젝트 – 스웜 모드를 사용하여 작업(코드 검토, 보안 감사, 문서화)을 여러 에이전트에 분할합니다.

문서 및 커뮤니티

  • 전체 문서는 저장소의 docs/ 폴더에 있습니다.
  • 릴리스는 Windows, macOS, Linux용 버전 바이너리로 GitHub에 게시됩니다.
  • 이슈, 기능 요청, 버그 보고는 GitHub 이슈 트래커를 통해 처리됩니다.
  • 기여를 환영합니다 – 지침은 CONTRIBUTING.md를 참조하세요.

요약

AlphaCode는 채팅 전용 제안을 넘어서는 Rust 네이티브 크로스 플랫폼 AI 코딩 어시스턴트입니다. 코드 편집, 셸 실행, 실제 Firefox 브라우저 구동, 데스크톱 앱 제어가 가능하며, 모두 터미널 UI에서 내장 안전 가드와 다양한 LLM 제공자를 지원합니다.


위 정보는 모두 저장소 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트