{"id":50661184,"url":"https://github.com/ziozzang/agentbridge","last_synced_at":"2026-06-08T02:33:53.171Z","repository":{"id":358157896,"uuid":"1240270706","full_name":"ziozzang/agentbridge","owner":"ziozzang","description":"Provider-neutral protocol bridge and compatibility gateway for AI agents","archived":false,"fork":false,"pushed_at":"2026-05-22T02:16:29.000Z","size":6748,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T02:33:52.473Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ziozzang.png","metadata":{"files":{"readme":"README.ko.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-16T00:19:16.000Z","updated_at":"2026-05-24T05:49:59.000Z","dependencies_parsed_at":"2026-05-20T15:03:28.472Z","dependency_job_id":null,"html_url":"https://github.com/ziozzang/agentbridge","commit_stats":null,"previous_names":["ziozzang/glm-acp","ziozzang/agentbridge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ziozzang/agentbridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziozzang%2Fagentbridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziozzang%2Fagentbridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziozzang%2Fagentbridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziozzang%2Fagentbridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ziozzang","download_url":"https://codeload.github.com/ziozzang/agentbridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziozzang%2Fagentbridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34046003,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-08T02:33:53.067Z","updated_at":"2026-06-08T02:33:53.163Z","avatar_url":"https://github.com/ziozzang.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AgentBridge\n\nAgentBridge는 여러 LLM provider와 여러 에이전트 프로토콜을 하나의\n백엔드로 연결하는 프로토콜 브리지이자 호환 게이트웨이입니다. ACP,\nA2A, MCP Streamable HTTP, OpenAI 호환 HTTP API, Anthropic Messages 호환\nAPI, AG-UI, gRPC를 공통 provider 백엔드 위에서 제공합니다.\n\n이 프로젝트는 `glm-acp`로 시작했지만, 이제 GLM 전용도 아니고 ACP 전용도\n아니므로 `agentbridge`로 이름을 바꿉니다. 기존 `ACP_HARNESS_*`,\n`ACP_GLM_*`, `Z_AI_API_KEY`, 예전 credential/session 경로는 가능한 범위에서\n하위 호환으로 유지합니다.\n\nEnglish documentation: [README.md](README.md)\n\n## 주요 기능\n\n- **여러 프로토콜, 하나의 백엔드**: ACP stdio/TCP, A2A JSON-RPC, MCP\n  Streamable HTTP, OpenAI Chat Completions, OpenAI Responses, Anthropic\n  Messages, AG-UI SSE, gRPC.\n- **여러 provider**: GLM/Z.AI, OpenAI, OpenAI Responses, Anthropic, Ollama,\n  OpenRouter, LiteLLM 호환 게이트웨이, Codex OAuth, Claude Code CLI.\n- **서버 모드**: bounded TCP ACP pool, HTTP 호환 listener, gRPC listener.\n- **관측성**: rotation을 지원하는 leveled logging, `/metrics` Prometheus\n  metrics.\n- **OpenAPI/Swagger**: `/openapi.json`, `/v1/openapi.json`, `/swagger`.\n- **플러그인**: SQLite와 DuckDB 확장 표면.\n- **런타임 제어**: ACP session에서 terminal/runtime command로 checkpoint,\n  rollback, markdown skill injection을 지원합니다.\n- **터미널 ACP 클라이언트**: `acp-agent`는 streaming 출력, context/status bar,\n  숫자 기반 permission overlay, message/tool/status history cell, Lua\n  orchestration, local goal, attachment, checkpoint, prompt queue, Ctrl-C prompt\n  cancellation을 제공하는 Codex/Claude 스타일 터미널 client입니다.\n- **하위 호환성**: 기존 `ACP_HARNESS_*`, `ACP_GLM_*`, `Z_AI_API_KEY`를 계속\n  허용합니다.\n\n## 빠른 시작\n\n```bash\ngo build -o agentbridge ./cmd/agentbridge\n```\n\nACP stdio agent로 실행:\n\n```bash\nAGENTBRIDGE_PROVIDER=openai \\\nAGENTBRIDGE_API_KEY=\"$OPENAI_API_KEY\" \\\nAGENTBRIDGE_MODEL=gpt-4.1-mini \\\n./agentbridge\n```\n\nHTTP 호환 게이트웨이로 실행:\n\n```bash\nAGENTBRIDGE_PROVIDER=glm \\\nZ_AI_API_KEY=\"$Z_AI_API_KEY\" \\\nAGENTBRIDGE_GLM_MODEL=glm-5.1 \\\n./agentbridge --http-listen 127.0.0.1:8766\n```\n\nACP TCP, HTTP, gRPC를 함께 실행:\n\n```bash\n./agentbridge \\\n  --server --listen 127.0.0.1:8765 --pool-size 6 --wait-size 3 \\\n  --http-listen 127.0.0.1:8766 \\\n  --grpc-listen 127.0.0.1:8767\n```\n\n터미널 ACP client로 접속:\n\n```bash\ngo build -o acp-agent ./cmd/acp-agent\n./agentbridge --server --listen 127.0.0.1:8765\n./acp-agent --addr 127.0.0.1:8765 --model glm-5.1\n```\n\n## HTTP 라우트\n\n- `POST /v1/chat/completions`\n- `POST /v1/responses`\n- `POST /v1/responses/compact`\n- `GET /v1/responses/{id}`\n- `POST /v1/messages`\n- `POST /v1/embeddings`\n- `POST /v1/rerank`\n- `GET /v1/models`\n- `GET /v1/providers/status`\n- `POST /v1/a2a/rpc`\n- `GET /.well-known/agent-card.json`\n- `POST /v1/mcp`\n- `GET /v1/mcp/catalog`\n- `GET /v1/tool-catalog`\n- `POST /v1/tools/{tool-name}`\n- `POST /v1/agui/run`\n- `GET /openapi.json`\n- `GET /swagger`\n- `GET /ui/`\n- `GET /metrics`\n- `GET /health`\n\n대부분의 호환 라우트는 `/v1` prefix 없이도 동작합니다.\n\n## gRPC\n\ngRPC service 이름은 `agentbridge.v1.AgentService`입니다.\n\n- `Chat`\n- `ChatStream`\n- `A2A`\n- `A2AStream`\n\nrequest/response는 `google.protobuf.Struct`를 사용하므로 프로젝트 전용 stub\n생성 없이 표준 gRPC/protobuf transport를 사용할 수 있습니다.\n`grpc.health.v1.Health`도 등록됩니다.\n\n## 설정\n\n새 설정 prefix는 `AGENTBRIDGE_*`입니다.\n\n| 변수 | 용도 |\n| --- | --- |\n| `AGENTBRIDGE_PROVIDER` | 활성 provider. 기본값: `glm`. |\n| `AGENTBRIDGE_MODEL` | 기본 모델 override. |\n| `AGENTBRIDGE_API_KEY` | 활성 provider API key. |\n| `AGENTBRIDGE_BASE_URL` | base URL override. |\n| `AGENTBRIDGE_CONFIG_FILE` | 전체 config YAML override. |\n| `AGENTBRIDGE_PROVIDERS_FILE` | provider YAML override. |\n| `AGENTBRIDGE_ROUTER_FILE` | Model-router route YAML/JSON override. |\n| `AGENTBRIDGE_PLUGINS` | 활성화할 plugin 목록. 예: `sqlite`. |\n| `AGENTBRIDGE_LOG_LEVEL` | `trace`, `debug`, `info`, `warn`, `error`, `off`. |\n| `AGENTBRIDGE_LOG_FILE` | 선택적 log file 경로. |\n| `AGENTBRIDGE_SESSION_DIR` | session 저장 디렉터리. |\n\n기존 `ACP_HARNESS_PROVIDER`, `ACP_HARNESS_API_KEY`, `ACP_GLM_MODEL`,\n`ACP_GLM_SESSION_DIR` 등은 하위 호환 alias로 계속 동작합니다.\n\n## 문서\n\n| 영어 | 한국어 |\n| --- | --- |\n| [Install](docs/install.md) | [설치](docs/ko/install.md) |\n| [Configuration](docs/configuration.md) | [설정](docs/ko/configuration.md) |\n| [Architecture](docs/architecture.md) | [아키텍처](docs/ko/architecture.md) |\n| [CLI Orchestration Design](docs/cli-orchestration.md) | [CLI Orchestration 설계](docs/ko/cli-orchestration.md) |\n| [Tool Placement](docs/tool-placement.md) | [Tool Placement](docs/ko/tool-placement.md) |\n| [Safety Pipeline](docs/safety.md) | [Safety Pipeline](docs/ko/safety.md) |\n| [Providers](docs/providers.md) | [프로바이더](docs/ko/providers.md) |\n| [Plugins](docs/plugins.md) | [플러그인](docs/ko/plugins.md) |\n| [Testing](docs/testing.md) | [테스트](docs/ko/testing.md) |\n\n## 테스트\n\n```bash\ngo test ./...\ngo vet ./...\ngo build -o agentbridge ./cmd/agentbridge\n```\n\n## 라이선스\n\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziozzang%2Fagentbridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fziozzang%2Fagentbridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziozzang%2Fagentbridge/lists"}