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) 등. |
일반적인 워크플로
- 목표 설명 – 예: "
utils.rs의 실패하는 테스트를 수정하고 회귀 테스트를 추가하세요." - AlphaCode가 저장소를 분석하고 계획을 세우며 호출할 도구를 결정합니다.
- 실행 – 파일을 편집하고
cargo test를 실행하며 UI를 확인하기 위해 Firefox를 열거나 데스크톱 앱을 클릭합니다. - 검증 – 관련 테스트를 다시 실행하고 스크린샷이나 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에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트