오픈 소스, 자체 호스팅 LangGraph Agent 서버입니다.
Production Postgres + Redis를 사용합니다. SDK도 동일하고 Studio도 동일하며 코드 변경이 전혀 필요 없습니다.
독립적인 프로젝트이며 LangChain과 제휴하거나 보증되지 않습니다.
만약 이것이 여러분의 라이선스 키(또는 주말)를 절약해 준다면,
⭐ 이 레포지토리를 스타(star)해주세요
— 이는 100% 오픈 소스 노력을 지속시키는 데 도움이 됩니다.
uv add langhost를 통해 라이브 Agent Server에 추가하세요 — 동일한 SDK, 동일한 Studio, 여러분의 Postgres + Redis가 연결됩니다.
데모를 클릭하여 일시 정지/탐색(pause / seek)을 해보세요.
langhost는 여러분의 Postgres와 Redis에서 프로덕션 등급의 LangGraph Agent Server를 실행하는 오픈 방식입니다 — 폐쇄형 런타임이나 지속성을 위한 라이선스 키가 필요 없습니다.
이는 LangGraph 생태계와 100% 호환됩니다. 기존 LangGraph 프로젝트(정상적인 langgraph.json을 사용하는)는 어떤 코드 변경 없이 실행될 수 있습니다: langhost를 추가하고, Postgres + Redis를 지정하며, 서비스만 하면 됩니다.
호환되는 항목:
LangSmith Studio · langgraph-sdk · Agent Protocol · Agent Chat UI · MCP · A2A · AG-UI / CopilotKit
langgraph dev | LangSmith Deployments | Aegra | langhost |
|---|
| 최적의 용도 | 빠른 로컬 반복(Fast local iteration) | 관리형 클라우드 또는 라이선스 기반 자체 호스팅 | 오픈 FastAPI 스택을 사용한 자체 호스팅 프로덕션 |
| 지속성 백엔드 (Persistence backend) | In-memory + 로컬 디스크 (.langgraph_api ) | Postgres + Redis | Postgres + Redis |
| 지속성 런타임 (Persistence runtime) | 독점적 (langgraph-runtime-inmem, Elastic-2.0) | 독점적 (라이선스 기반) | 오픈 (Apache-2.0) |
| HTTP / API 스택 | 공식 Agent Server | 공식 Agent Server | 독립적인 FastAPI 구현체 |
| 공식 프로토콜 및 추가 기능 | MCP, A2A, 생성형 UI, 웹훅 | MCP, A2A, 생성형 UI, 웹훅 | 핵심 Agent Protocol; MCP / A2A 곧 출시 예정 |
| LangGraph SDK / Studio | Yes | Yes | Yes |
| 설정 (Config) | langgraph.json | langgraph.json | aegra.json (langgraph.json으로 폴백) |
| 프로젝트 라이선스 | | | |
Elastic-2.0 (런타임) | 독점/상업용 | Apache-2.0 | MIT |
자체 호스팅 라이선스 키 |
필요 없음 (개발) | 필요함 (LANGGRAPH_CLOUD_LICENSE_KEY) |
없음 | 없음 |
공식 langgraph dev
은 인메모리 개발에 이상적입니다. Aegra는 에이전트 프로토콜(Agent Protocol) 서비스 계층을 오픈 FastAPI 스택으로 재구현했습니다. langhost는 기존의 langgraph-api를 유지하고 MIT 지속성 기능을 교체하여, 동일한 MCP / A2A / 생성형 UI / 웹훅, 영속적 상태 관리 및 라이선스 키 없이 작동합니다.
Studio / SDK / Chat UI / MCP / A2A
│
▼
...
— 사용하기 쉬운 CLI(langhost
langhost serve
)— 백본(backbone): clean-room Postgres + Redis 런타임 (LANGGRAPH_RUNTIME_EDITION=pg)
으로, 기존 langgraph-api에 플러그인됩니다.
사용자 그래프(Your graphs)— 이미 langgraph.json에 가지고 있는 모든 것들
; 재작성 불필요
API 포크도 없고, 두 번째 프로토콜도 없습니다. 클라이언트는 공식 에이전트 서버와 계속 통신합니다.
사전 요구 사항(Prerequisites): Python 3.11+, uv, Docker (로컬 Postgres/Redis가 필요한 경우에만)
공식 로컬 서버 가이드와 동일한 흐름을 따릅니다:
uvx --from langgraph-cli@latest langgraph new
화면의 안내를 따라 진행한 후 다음 명령어를 실행합니다:
이미 LangGraph 프로젝트가 있습니까? 스캐폴딩(scaffolding) 과정은 건너뛰고 다음 단계로 이동하세요.
uv add langhost
이 명령어가 자동으로 langgraph-runtime-pg (오픈 런타임)를 가져옵니다.
아직 실행하고 있지 않다면 다음을 수행합니다:
docker compose -f https://github.com/langhost/langhost.git#main:docker-compose.yml up -d
프로젝트 루트에 .env 파일을 생성하거나 업데이트하세요:
DATABASE_URI=postgresql+asyncpg://postgres:postgres@localhost:5432/langgraph?sslmode=disable
REDIS_URI=redis://localhost:6379/0
필요한 경우 다른 환경 변수를 추가하세요.
# 개발 — 코드 변경 시 핫 리로드
uv run langhost serve --reload
# 프로덕션 — 모든 인터페이스에 바인딩; 필요에 따라 워커 스케일링
...
기본 포트는 31296입니다. 배너에서 API, Studio, 문서(docs), 에이전트 채팅 UI URL을 확인할 수 있습니다:
API:http://127.0.0.1:31296
Studio: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:31296
Docs: http://127.0.0.1:31296/docs
Agent Chat UI: https://agentchat.vercel.app/?apiUrl=http://127.0.0.1:31296&assistantId=agent
팁: Safari는 종종 localhost ↔ Studio를 차단합니다. 다음을 사용하세요.
uv run langhost serve --reload --tunnel
from langgraph_sdk import get_client
import asyncio
client = get_client(url="http://127.0.0.1:31296")
...
동일한 SDK, 동일한 엔드포인트, 동일한 Studio. 완벽하게 자체 호스팅됩니다.
100% 오픈 소스 (MIT) — 감사(audit), 포크(fork) 및 어디서든 실행할 수 있는 런타임 + CLI
기존 LangGraph 앱에 드롭인(Drop-in) — langgraph.json과 그래프 코드를 유지하세요
공식 Agent Server 인터페이스 — 어시스턴트(assistants), 스레드(threads), 실행(runs), 저장소(store), 크론(crons), SSE 스트리밍
Studio 사용 준비 완료 — 인쇄된 Studio URL을 열고 로컬 langgraph dev처럼 디버깅하세요
생태계 프로토콜 — Agent Protocol (LangChain) 및 스톡 서버의 MCP / A2A 인터페이스
수평 확장(Horizontal scale) — Postgres + Redis에서 다중 복제본 클레임/클레임 해제
1차 파티 체크포인트 — langgraph-checkpoint-postgres를 통해 관리합니다
스키마는 langgraph-runtime-pg 내부의 Alembic에 의해 관리됩니다.
:
export DATABASE_URI=postgresql+asyncpg://postgres:postgres@localhost:5432/langgraph
uv run langgraph-runtime-pg-migrate upgrade
uv run langgraph-runtime-pg-migrate current
| 환경 | 권장 사항 |
|---|
| 개발(Dev) / 테스트(tests) | 자동 마이그레이션 활성화 (기본값) |
| 프로덕션(Production) | 배포 전에 한 번 migrate 실행; 자동 마이그레이션 비활성화 |
libs/langhost/ # CLI: langhost serve
libs/langgraph-runtime-pg/ # 오픈 Postgres + Redis 런타임 (백본)
docker-compose.yml # 로컬 Postgres 16 + Redis 7
...
git clone https://github.com/langhost/langhost.git
cd langhost
uv sync --group dev
...
CONTRIBUTING.md를 참조하세요.
MIT © Mohankumar Ramachandran — 100% 오픈 소스.
LangChain과 제휴하지 않습니다. 스톡 langgraph-api를 실행할 때
, 사용자는 여전히 해당의 Elastic License 2.0을 준수해야 합니다. 이 프로젝트는 폐쇄된 Postgres/Redis 런타임을 대체하는 것이지, API 패키지의 라이선스를 대체하는 것은 아닙니다.
오픈 소스로 구축되었습니다. 만약 langhost가 배포에 도움이 된다면, 별 하나(star)가 큰 힘이 됩니다. ⭐