agnt-gg/agnt
The local-first operating system for building, running, and improving AI agents, workflows, and autonomous goals.
AGNT – 로컬 우선 에이전트 운영 체제
개요 – AGNT는 AI 에이전트 런타임, 시각적 워크플로우 엔진, 목표 관리자, 메모리 저장소, 플러그인 시스템 및 로컬 HTTP API를 하나의 '에이전트 운영 체제'로 통합한 데스크톱 우선, 자체 호스팅 가능한 플랫폼입니다. UI는 Electron + Vue, 백엔드는 Express, 데이터 영속성은 SQLite를 사용합니다.
핵심 개념
| 개념 | 기능 | 사용 사례 |
|---|---|---|
| Agents | 메모리, 도구 사용, 스트리밍 응답 및 비용 계산 기능을 갖춘 지속적인 채팅 스타일의 AI 작업자. | 판단력, 추론 또는 과거 상호작용을 기억하는 대화형 인터페이스가 필요할 때. |
| Workflows | 60개 이상의 노드 유형(트리거, 분기, 체크포인트, 중첩된 하위 워크플로우)을 갖춘 드래그 앤 드롭 DAG 캔버스. 반복 가능한 자동화 실행. | 코드를 작성하지 않고 데이터 스크래핑, 모델 실행, 결과 저장과 같은 반복 가능한 파이프라인을 원할 때. |
| Goals | 계획, 실행, 평가가 가능하며 재계획, 일시 중지 또는 되돌리기가 가능한 장기 목표. | '제품 출시 발표'와 같이 여러 단계를 거치며 피드백 루프가 필요한 프로젝트. |
| Sub‑agents / delegation | 모든 에이전트, 워크플로우, 도구, 플러그인 또는 외부 서비스를 하위 작업으로 호출 가능하며 완전한 추적성 제공. | 병렬 또는 계층적 작업(예: 한 에이전트에게 조사를 위임하고 다른 에이전트에게 초안 작성을 맡기는 경우). |
| Memory & insights | SQLite 기반의 사실, 선호도, 수정 사항, 병목 현상 감지 및 실행 추적을 재사용 가능한 기술로 변환하는 SkillForge. | 실행 간에 지속적인 상태를 유지하고 시간이 지남에 따라 시스템이 개선되기를 원할 때. |
| Plugins | 도구, 트리거, 위젯, 핫 리로드 지원을 추가하고 마켓플레이스를 통해 공유할 수 있는 .agnt 패키지. |
사용자 지정 API, Web‑hooks 또는 UI 구성 요소로 플랫폼을 확장할 때. |
| Local API | 에이전트, 워크플로우, 목표, 도구, 파일, 플러그인, MCP, 기술, 통찰력 및 실행을 노출하는 HTTP + Socket.IO 엔드포인트 (http://localhost:3333/api). |
스크립트, 다른 서비스 또는 CI 파이프라인에서 AGNT를 구동할 때. |
| Provider freedom | 15개 이상의 LLM 공급자(OpenAI, Anthropic, Gemini, Groq 등) 및 사용자 지정 엔드포인트 지원. | 모델을 전환하거나 모든 것을 온프레미스로 유지할 수 있습니다. |
대상 사용자
- 개발자: 백엔드를 처음부터 구축하지 않고 UI 기반으로 자율 AI 파이프라인을 프로토타이핑하려는 분.
- 팀: 데이터, 공급자 키 및 실행 로그를 로컬에서 소유해야 하는 팀(자체 호스팅 SaaS 대안).
- 연구원: 에이전트 동작을 평가, 추적 및 반복하는 데 관심이 있는 분(내장 평가 및 SkillForge).
- 파워 유저: 메시징 플랫폼(Telegram, Discord, Slack, 이메일)을 자동화하고 AI와 결합하려는 분.
이것은 단순한 챗봇이나 호스팅된 SaaS 자동화 도구가 아니며, 실행하려면 로컬 머신이나 서버가 필요합니다.
시작하기 (README에서)
- 복제 및 설치
git clone https://github.com/agnt-gg/agnt.git cd agnt npm install cd frontend && npm install && cd .. npm start # launches Electron + backend on http://localhost:3333 - 개발 모드 – 한 터미널에서 Vue 개발 서버(
frontend에서npm run dev)를 실행하고 다른 터미널에서 백엔드(npm start)를 실행합니다. - Docker / 헤드리스 –
ghcr.io/agnt-gg/agnt:latest이미지를 가져와 3333 포트를 노출하거나docker‑compose up -d로 빌드합니다. x86_64 및 ARM64(Raspberry Pi)에서 작동합니다. - API 사용 –
http://localhost:3333/api/agents,.../workflows등에 JSON을 보내고 실시간 스트리밍을 위해 Server‑Sent Events / Socket.IO 업데이트를 받습니다.
주요 기능
- 60개 이상의 워크플로우 노드 (트리거, webhooks, Zapier, 사용자 지정 API, Chromium을 통한 브라우저 자동화).
- 플러그인 마켓플레이스 (25개 이상의 템플릿).
- MCP 지원 (다중 채널 프로토콜) 외부 도구 공급자용.
- 로컬 우선 – 모든 데이터는 로컬 SQLite DB 및 파일 시스템에 저장됩니다.
- 크로스 플랫폼 – Windows, macOS, Linux, Docker, Raspberry Pi.
- SkillForge – 실행 추적에서 재사용 가능한 지침을 자동으로 추출.
- 실시간 UX – SSE 스트림과 Socket.IO가 UI를 실행 중인 에이전트와 동기화 상태로 유지.
AI 에이전트 생태계에서의 위치
| 카테고리 | AGNT의 역할 |
|---|---|
| 에이전트 프레임워크 (LangChain, AutoGen, CrewAI) | 기본 에이전트 개념 위에 완전한 데스크톱 UI, 로컬 저장소, 워크플로우 캔버스 및 플러그인 시스템을 제공합니다. |
| 자동화 플랫폼 (n8n, Zapier) | 지속적인 메모리, LLM 기반 추론, 목표 관리 및 스스로 개선하는 기술을 추가합니다. |
| 자체 호스팅 AI 워크스페이스 (OpenWebUI, Claude Code) | 채팅을 반복 가능한 워크플로우, 하위 에이전트, 평가 파이프라인 및 플러그인 마켓플레이스로 확장합니다. |
빠른 평가 체크리스트
- 로컬 데이터 제어가 필요하십니까? → 예, AGNT는 모든 것을 로컬에 저장합니다.
- 시각적 워크플로우 빌더를 원하십니까? → DAG 캔버스가 내장되어 있습니다.
- 다중 모델 지원이 필요하십니까? → 15개 이상의 공급자 + 사용자 지정 엔드포인트.
- 단순한 챗봇만 필요하십니까? → 아마도 과한 기능일 수 있습니다. 더 가벼운 UI를 고려하세요.
결론
AGNT는 LLM 에이전트 런타임, 로우 코드 워크플로우 엔진, 목표 지향 플래너 및 플러그인 마켓플레이스의 기능을 하나의 자체 호스팅 가능한 데스크톱 애플리케이션으로 결합한 진정한 오픈 소스 '에이전트 운영 체제'입니다. 자신의 하드웨어에서 실행하고 확장할 수 있는 내구성 있고 검사 가능한 AI 자동화를 원하는 개발자와 파워 유저를 대상으로 합니다.
위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부적인 가정은 추가되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트