The open-source agent harness - the runtime layer that turns an LLM into a working agent.

TrueForge – 오픈소스 LLM 에이전트 런타임

개요 – TrueForge는 TypeScript 기반의 "에이전트 하네스"입니다. 언어 모델 기반 에이전트의 실행 루프(모델 호출, 도구 실행, 샌드박스 코드 실행 관리, 승인 처리, 세션 상태 영속화)를 제어하며, 세 가지 인터페이스를 통해 기능을 제공합니다.

Chat UI – 즉시 사용 가능한 웹 인터페이스.
HTTP API – OpenAPI 사양을 준수하는 REST 엔드포인트.
SDKs – TypeScript 클라이언트 (@truefoundry/trueforge-sdk) 및 임베드 가능한 UI 컴포넌트 (@truefoundry/trueforge-ui).

개발자가 에이전트 로직에 집중할 수 있도록 인프라의 복잡한 부분을 TrueForge가 대신 처리하도록 설계되었습니다.

주요 특징

올인원 인프라 – 스트리밍 응답, 세션 영속화, 도구 서버, 샌드박스, 인간 승인 및 컨텍스트 관리가 내장되어 있습니다.
플러그형 리소스 – 모델(OpenAI, Anthropic, Gemini 또는 OpenAI 호환 엔드포인트), MCP 도구 서버, 스킬 팩(git 기반 SKILL.md 파일), 샌드박스 제공자(현재 Daytona)를 YAML 카탈로그를 통해 설정할 수 있습니다.
확장 가능한 배포 – 단일 프로세스와 SQLite를 사용한 로컬 실행부터, Postgres + Redis를 사용하는 Docker-Compose, Helm, Railway를 통한 호스팅 환경까지 지원합니다.
비용 효율성 – 벤치마크 결과, 더 적은 컴퓨팅 자원으로 Claude Managed Agents 및 deepagents와 동일한 정확도를 제공합니다.

퀵스타트 (한 줄 명령어)

npx @truefoundry/trueforge@latest

이 명령어로 로컬 인스턴스(SQLite 사용, 외부 인프라 불필요)가 실행됩니다. 화면의 안내 또는 quick-start guide에 따라 모델을 연결하고 도구/스킬을 추가하여 채팅을 시작하세요.

핵심 아키텍처 (개요)

+-------------------+      +-------------------+      +-------------------+
|   Chat UI / SDK   | <--->|   TrueForge HTTP  | <--->|   Agent loop      |
| (web or embed)    |      |   API (REST)      |      | (model calls,    |
+-------------------+      +-------------------+      |  MCP tools,      |
                                                   |  sandbox, state) |
                                                   +-------------------+

스토리지 – 로컬 모드에서는 SQLite, 호스팅 모드에서는 Postgres(캐싱용 Redis)를 사용합니다.
리소스 – 에이전트 루프는 YAML 카탈로그를 읽어 모델, MCP 서버, 스킬 및 샌드박스 제공자를 탐색합니다.
도구로서의 샌드박스 – 코드는 격리된 환경에서 실행되며, 보안 정보는 하네스 내부에 유지됩니다.
인간 체크포인트 – 도구 실행 전 선택적인 승인 단계 또는 "사용자에게 묻기" 프롬프트.

도입 가이드

모드	용도	실행 방법
Local	개인 실험, 프로토타이핑	`npx @truefoundry/trueforge` (SQLite, 로그인 불필요)
Hosted	팀 협업, 프로덕션 환경	Docker-Compose, Helm chart 또는 Railway로 배포; Postgres + Redis 설정

문서 내용:

초기 설정 – 모델, MCP 서버, 스킬, 샌드박스 카탈로그 설정.
에이전트 생성 – 리소스 선택, 도구 승인 활성화, 생성형 UI 추가.
세션 및 스케줄 – 과거 실행 기록 확인, 주기적 에이전트 설정.
인증 – 공유 배포를 위한 선택적 OIDC.
벤치마크 – benchmark/ 내 비용/정확도 비교 재현.

설치 및 생태계

npm 패키지 – @truefoundry/trueforge (CLI/서버), @truefoundry/trueforge-sdk, @truefoundry/trueforge-ui, @truefoundry/trueforge-core.
Helm chart – Kubernetes용으로 tfy.jfrog.io/...에 게시.
문서 – https://trueforge.dev (소개, API 참조, UI 가이드 등).

커뮤니티 및 기여

Discord – https://discord.com/invite/fHeGRvakb
Issues / PRs – 표준 GitHub 워크플로우를 따르세요. 병합 후 메인테이너가 SDK를 재생성합니다.
보안 – SECURITY.md를 통해 보고하세요.
라이선스 – MIT.

요약

TrueForge는 LLM 에이전트를 위한 프로덕션급 런타임을 제공합니다. 모델을 연결하고 도구/스킬을 추가하기만 하면, 샌드박스, 승인, 영속화 처리를 하네스가 담당합니다. 웹 UI나 TypeScript SDK를 통해 상호작용할 수 있으며, 로컬 테스트부터 팀 단위의 Kubernetes 운영까지 폭넓게 대응 가능합니다.

truefoundry/trueforge