androoAGI/starnet — A living pixel-art station where real AI agents do real work. Local-first desktop agent harness - bring your own key, watch your crew actually run.
androoAGI/starnet — 실제 작업을 수행하는 AI 에이전트 픽셀 아트 스테이션
StarNet은 여러 AI 에이전트를 픽셀 아트 우주 정거장에 배치해 실행하는 로컬 우선 데스크톱 도구입니다. 화면의 방과 통로, 오브젝트가 각각 에이전트 팀의 권한 범위, 승인된 작업 전달 경로, 실제 기능 권한을 나타내며 실행 상태를 반영합니다.
- 주제
에디터 노트
이 프로젝트의 진짜 무기는 픽셀 아트가 아니라 정직함입니다. 핵심 원칙이 "하네스가 증명할 수 없는 상태를 화면에 표시하지 않는다"거든요. 방이 권한 범위고, 통로가 승인된 작업 경로고, 놓은 오브젝트가 실제 권한 부여라는 설계는 귀엽게 보이지만, 에이전트의 권한 구조를 시각적으로 감사(audit)할 수 있게 만든 겁니다. 오픈클로(개인 비서를 메신저에 넣는 방식)나 헤르메스(헤드리스 하네스)와 비교하면 StarNet의 자리는 명확합니다. 여러 에이전트를 팀으로 굴리면서 그 권한 관계를 화면으로 관리하는 데스크톱 관제 도구라는 것이죠. Night Shift처럼 자리를 비운 사이에도 돌리되 모든 동작을 기록·검토할 수 있게 한 점도 이 방향과 맞닿아 있습니다. 다만 한계도 스스로 밝힙니다. 6월 공개 후 커밋 1만 개가 넘을 정도로 활발하지만 스타는 327개, macOS는 실사용 검증이 적습니다. 오픈클로가 34만 스타의 생태계를 가진 지금, StarNet이 살아남으려면 픽셀 아트 이상의 이유가 필요한데, 그게 '정직한 하네스'가 될 수 있을지 지켜볼 일입니다.
AI 요약
StarNet은 AI 에이전트를 만들고 여러 에이전트를 동시에 실행하는 로컬 우선 데스크톱 하네스입니다. 픽셀 아트 우주 정거장은 단순한 장식이 아닙니다. 방은 특정 기능 범위를 가진 팀이며, 통로는 승인된 작업 전달 경로입니다. 배치한 오브젝트는 실제 기능 권한을 부여합니다. 사용자가 그리는 정거장 배치가 에이전트의 작업 흐름이 됩니다.
에이전트 실행과 권한
에이전트마다 클래스, 페르소나, 도구 구성을 따로 설정합니다. 각 실행은 별도의 작업 공간과 대화 기록, 메모리를 가지며 권한 범위도 제한됩니다. 실제 모델 호출과 도구 실행을 수행하고, 작업 비용도 기록합니다. 여러 에이전트를 동시에 실행할 수 있습니다. 도구는 명시적인 기능 권한과 동의 확인을 거칩니다. 작업이 모호하면 Task Briefs가 연결된 채널을 통해 선택지가 있는 질문을 던져 잘못된 추측을 줄입니다.
Night Shift를 켜면 사용자가 자리를 비운 동안에도 에이전트가 작업을 이어갑니다. 허용 범위는 조절할 수 있으며, 자리 비운 뒤 실행한 동작은 기록하고 검토할 수 있습니다. Recipes와 skills로 여러 단계 작업이나 재사용 기능을 실행하고, cron 일정도 설정합니다. 결과 파일은 대화 기록이 아니라 OUTBOX에 저장합니다. 지출, 예산, 실행 기록은 디스크에 남깁니다.
연결 방식과 데이터
OpenRouter API 키를 입력하거나 Anthropic, OpenAI, Google 계정으로 연결합니다. 키는 프런트엔드가 아니라 OS 키체인에 보관합니다. Ollama를 설치하면 로컬 모델도 쓸 수 있습니다. StarNet은 로컬 모델 목록을 확인한 뒤 연결 상태를 표시하며, 장시간 작업에서는 클라우드 모델보다 느리고 결과가 거칠 수 있다고 안내합니다. Telegram, Discord, Slack, Signal, Matrix에서 에이전트와 대화할 수 있고, MCP 서버와 키 입력 또는 OAuth 방식의 커넥터도 연결합니다.
런타임은 로컬 Node.js 사이드카에서 실행하며 모델 호출은 이 사이드카를 거칩니다. 프런트엔드는 localhost의 HTTP/NDJSON 및 SSE 이벤트를 받아 정거장 화면을 갱신합니다. 상태, 대화 기록, 메모리, 지출 기록, 작업과 일정은 로컬 디스크에 저장합니다. 에이전트를 실행하면 제공자에게 요청이 전송되며, 네트워크 도구나 커넥터를 직접 쓰지 않는 한 나머지 상태는 로컬 작업 공간에 남습니다. 프로젝트는 하네스가 확인할 수 없는 실행 상태를 화면에서 사실처럼 표시하지 않는 것을 원칙으로 둡니다.
빌드와 배포
Windows와 macOS용 데스크톱 설치 파일을 공개합니다. Windows가 가장 많이 검증된 대상이며 macOS는 실제 사용 검증이 적습니다. Linux 패키지는 내부 빌드 산출물일 뿐 공개 지원 대상은 아닙니다. 공개 릴리스 과정에서는 Windows 설치 파일의 Authenticode 서명과 타임스탬프, macOS 빌드의 Developer ID 및 공증, 업데이터 서명을 확인합니다. 프로젝트는 이 파이프라인 검증이 개별 사용자의 다운로드 파일까지 테스트했다는 뜻은 아니라고 명시합니다.
개발 환경에는 Node.js 18 이상과 Git이 필요합니다. 데스크톱 셸 개발에는 Rust와 Tauri 요구 사항도 필요합니다. 테스트 명령으로 빠른 병합 검사, HTTP 및 E2E 테스트, 전체 테스트를 실행하며, 릴리스 준비 검사는 후보 커밋에 묶입니다. 새 커밋이 들어오면 해당 검사 결과를 다시 받아야 합니다. 코드는 MIT License로 공개하지만 프로젝트 이름, 로고, 그림 등 브랜드 자산은 라이선스 대상에서 제외합니다. 포크와 파생 프로젝트는 별도 이름과 시각 자산을 써야 합니다.
원문: GitHub / 번역·요약: Trawling