{"id":41235911,"url":"https://github.com/inkeep/complex-agent","last_synced_at":"2026-01-23T01:03:30.264Z","repository":{"id":319001732,"uuid":"1077225360","full_name":"inkeep/complex-agent","owner":"inkeep","description":null,"archived":false,"fork":false,"pushed_at":"2025-10-30T21:12:08.000Z","size":598,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-03T08:28:06.024Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/inkeep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":null,"dco":null,"cla":null}},"created_at":"2025-10-16T00:50:49.000Z","updated_at":"2025-10-24T23:34:59.000Z","dependencies_parsed_at":"2025-10-17T17:43:16.331Z","dependency_job_id":null,"html_url":"https://github.com/inkeep/complex-agent","commit_stats":null,"previous_names":["inkeep/complex-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/inkeep/complex-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkeep%2Fcomplex-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkeep%2Fcomplex-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkeep%2Fcomplex-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkeep%2Fcomplex-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inkeep","download_url":"https://codeload.github.com/inkeep/complex-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inkeep%2Fcomplex-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28676490,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T01:00:35.747Z","status":"ssl_error","status_checked_at":"2026-01-23T01:00:19.529Z","response_time":144,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-01-23T01:03:30.170Z","updated_at":"2026-01-23T01:03:30.238Z","avatar_url":"https://github.com/inkeep.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Inkeep Agent Framework Template \n\nAn Inkeep Agent Framework project with multi-service architecture.\n\n## Architecture\n\nThis project follows a workspace structure with the following services:\n\n- **Agents Manage API** (Port 3002): Agent configuration and managemen\n  - Handles entity management and configuration endpoints.\n- **Agents Run API** (Port 3003): Agent execution and chat processing  \n  - Handles agent communication. You can interact with your agents either over MCP from an MCP client or through our React UI components library\n- **Agents Manage UI** (Port 3000): Web interface available via `inkeep dev`\n  - The agent framework visual builder. From the builder you can create, manage and visualize all your graphs.\n\n## Quick Start\n\n[Follow these steps in the docs to get started](https://docs.inkeep.com/get-started/quick-start) with the `npx @inkeep/create-agents` CLI command.\n\n# Deploy using Vercel\n\n### 1. Prerequisites\nSign up for a cloud hosted deployment for these services:\n- [**Turso on Vercel**](https://vercel.com/marketplace/tursocloud) or directly at [**Turso Cloud**](https://app.turso.tech)\n- [**SigNoz**](https://signoz.io/)\n- [**Nango**](https://www.nango.dev/)\n\nFollow this guide for how to [Deploy the Inkeep Agent Framework to Vercel](https://docs.inkeep.com/self-hosting/vercel)\n\n# Deploy using Docker (development)\n\n### 1. Complete the quickstart or clone this repository\nFollow the quickstart using `npx @inkeep/create-agents` or clone this repository `git clone git@github.com:inkeep/create-agents-template.git`\n\n### 2. Prerequisites\n\n#### Required: Docker\n- [Install Docker Desktop](https://www.docker.com/)\n\n#### SigNoz and Nango\n\nFor full functionality, the **Inkeep Agent Framework** requires [**SigNoz**](https://signoz.io/) and [**Nango**](https://www.nango.dev/). You can sign up for a cloud hosted account with them directly, or you can self host them.\n\nFollow these instructions to self-host both **SigNoz** and **Nango**:\n\n1. Clone the `inkeep/agents-optional-local-dev` repo separately, with the docker files for SigNoz and Nango:\n```bash\ngit clone https://github.com/inkeep/agents-optional-local-dev.git\ncd agents-optional-local-dev\n```\n\n2. Create a `.env` file from the example with an auto-generated `NANGO_ENCRYPTION_KEY`:\n```bash\ncp .env.example .env \u0026\u0026 \\\n  encryption_key=$(openssl rand -base64 32) \u0026\u0026 \\\n  sed -i'' \"s|\u003cREPLACE_WITH_BASE64_256BIT_ENCRYPTION_KEY\u003e|$encryption_key|\" .env \u0026\u0026 \\\n  echo \"Docker environment file created with auto-generated encryption key\"\n```\n\n3. Build and deploy **SigNoz**, **Nango**, **OTEL Collector**, and **Jaeger**:\n```bash\ndocker compose \\\n  --profile nango \\\n  --profile signoz \\\n  --profile otel-collector \\\n  --profile jaeger \\\n  up -d\n```\n\n4. SigNoz API Key    \n\nTo get your SigNoz API key:\n- Open SigNoz at `http://localhost:3080`\n- Navigate to Settings → Account Settings → API Keys → New Key\n- Choose a role (Admin, Editor, or Viewer) - Viewer is sufficient for observability\n- Set the expiration field to \"No Expiry\" to prevent the key from expiring\n\n5. Nango Secret Key\n   \nTo get your Nango secret key:\n- Open Nango at `http://localhost:3050`\n- Navigate to Environment Settings and copy the secret key\n\n\u003e [!NOTE]  \n\u003e SigNoz and Nango run separately. You can get them running before proceeding with running the Inkeep Agent Framework   \n\n### 2. Setup Environment Variables   \n\nIn your agent project directory, generate a `.env.docker` file from the example:\n```bash\ncp .env.example .env.docker\n```\nThen update the `.env.docker` file with values specific to your environment.\n\n### 3. Run the Inkeep Agent Framework\n\n```bash\ndocker-compose -f docker-compose.standalone.yml --env-file .env.docker up -d\n```\n\nConfirm all services are running with `docker ps`:\n```\ninkeep/agents-run-api:latest\ninkeep/agents-manage-api:latest\ninkeep/agents-manage-ui:latest\nsignoz/signoz-otel-collector:v0.129.6\nsignoz/signoz:v0.96.1\nclickhouse/clickhouse-server:25.5.6\nnangohq/nango-server:hosted-0.68.0\nredis:7.2.4\npostgres:16.0-alpine\njaegertracing/all-in-one:1.73.0\notel/opentelemetry-collector:0.135.0\nsignoz/zookeeper:3.7.1\n```\n\n---\n\n## Automated Dependency Updates\n\nThis template uses **Renovate Bot** to automatically create PRs when new @inkeep packages are published.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finkeep%2Fcomplex-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finkeep%2Fcomplex-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finkeep%2Fcomplex-agent/lists"}