{"id":44367511,"url":"https://github.com/alexk-dev/golemcore-bot","last_synced_at":"2026-04-17T03:08:40.554Z","repository":{"id":337139132,"uuid":"1152434689","full_name":"alexk-dev/golemcore-bot","owner":"alexk-dev","description":"AI-native runtime for the GolemCore ecosystem with skills, plugins, MCP, memory, and Hive.","archived":false,"fork":false,"pushed_at":"2026-04-13T18:22:26.000Z","size":5440,"stargazers_count":40,"open_issues_count":7,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T18:23:27.460Z","etag":null,"topics":["agent-runtime","ai-agent","ai-assistant","anthropic","chatbot","conversational-ai","function-calling","golemcore","hive","llm","mcp","memory","model-context-protocol","observability","openai","plugin-runtime","rag","skills","telegram-bot","tool-use"],"latest_commit_sha":null,"homepage":"https://golemcore.me","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexk-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-07T21:44:24.000Z","updated_at":"2026-04-13T02:46:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alexk-dev/golemcore-bot","commit_stats":null,"previous_names":["alexk-dev/golemcore-bot"],"tags_count":128,"template":false,"template_full_name":null,"purl":"pkg:github/alexk-dev/golemcore-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexk-dev","download_url":"https://codeload.github.com/alexk-dev/golemcore-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexk-dev%2Fgolemcore-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31913107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"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":["agent-runtime","ai-agent","ai-assistant","anthropic","chatbot","conversational-ai","function-calling","golemcore","hive","llm","mcp","memory","model-context-protocol","observability","openai","plugin-runtime","rag","skills","telegram-bot","tool-use"],"created_at":"2026-02-11T19:00:36.347Z","updated_at":"2026-04-17T03:08:40.547Z","avatar_url":"https://github.com/alexk-dev.png","language":"Java","readme":"# GolemCore Bot\n\n\u003e Agent Platform for AI-Native Companies — build, run, extend, and inspect channel-connected agents with skills, plugins, MCP, memory, and Hive.\n\n[![CI](https://github.com/alexk-dev/golemcore-bot/actions/workflows/docker-publish.yml/badge.svg)](https://github.com/alexk-dev/golemcore-bot/actions/workflows/docker-publish.yml)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![Tests](https://img.shields.io/badge/tests-passing-success.svg)](https://github.com/alexk-dev/golemcore-bot/actions)\n\n---\n\n## What it is\n\nGolemCore Bot is the agent platform for AI-native companies building on the GolemCore ecosystem.\n\nUse it to run channel-connected agents, extend them with skills, plugins, and MCP servers, and operate them with memory, delayed follow-ups, trace inspection, and Hive-connected control flows.\n\nUse it in two ways:\n\n1. **Run agents** — chat in the dashboard, Telegram, or webhook-driven flows, then inspect execution, memory, and trace output.\n2. **Extend the runtime** — add skills, install plugins, connect MCP servers, configure routing tiers, and attach Hive-based control and inspection.\n\n## Why it is different\n\n- **Plugin-native runtime** — plugins can contribute tools, channels, voice providers, and RAG ingestion instead of living outside the agent runtime.\n- **MCP-ready by design** — skills can launch MCP servers, and the runtime now includes MCP catalog and discovery flows.\n- **Built for long-running work** — delayed follow-ups, progressive memory orchestration, and recovery paths help agents continue past a single turn.\n- **Hive-connected control surface** — connect agents to Hive for control commands, lifecycle signals, inspection, and host-level coordination.\n- **Inspectable execution** — traces, waterfall views, and exported snapshots make agent behavior easier to debug and operate.\n\n---\n\n## Quick start\n\n### What you need\n\n- Docker\n- At least one LLM provider API key\n\n### Run the published image\n\n```bash\ndocker pull ghcr.io/alexk-dev/golemcore-bot:latest\n\ndocker run -d \\\n  --name golemcore-bot \\\n  --shm-size=256m \\\n  --cap-add=SYS_ADMIN \\\n  -e STORAGE_PATH=/app/workspace \\\n  -e TOOLS_WORKSPACE=/app/sandbox \\\n  -v golemcore-bot-data:/app/workspace \\\n  -v golemcore-bot-sandbox:/app/sandbox \\\n  -p 8080:8080 \\\n  --restart unless-stopped \\\n  ghcr.io/alexk-dev/golemcore-bot:latest\n\ndocker logs -f golemcore-bot\n\n# Open http://localhost:8080/dashboard\n# On first start, check logs for the temporary admin password.\n```\n\nOpen `http://localhost:8080/dashboard`, sign in with the temporary admin password from the logs, then configure your LLM providers in Settings.\n\nWhy the extra Docker flags?\n- `--shm-size=256m` and `--cap-add=SYS_ADMIN` are needed for the **Browser tool** (Playwright/Chromium) in containers.\n  See **[Configuration → Browser Tool](docs/CONFIGURATION.md#browser-tool)**.\n\n### Optional next steps\n\n- Enable Telegram in Settings for channel-based chat.\n- Install plugins for browser, search, mail, weather, voice, or RAG-backed workflows.\n- Connect MCP-backed skills and tool servers.\n- Join Hive for control-plane coordination and inspection.\n\nNeed a local build, Compose setup, or production deployment path? See **[Quick Start](docs/QUICKSTART.md)** and **[Deployment](docs/DEPLOYMENT.md)**.\n\n---\n\n## First-run setup\n\n1. Open the dashboard.\n2. Add at least one LLM provider key in Settings.\n3. Verify the storage and sandbox volumes are mounted so sessions, skills, and runtime config persist.\n4. Optionally enable Telegram, install plugins, connect MCP-backed skills, or join Hive.\n\nFor runtime config details, storage layout, and browser or sandbox notes, see **[Configuration](docs/CONFIGURATION.md)**.\n\n---\n\n## Documentation\n\nDocumentation site: https://docs.golemcore.me/\n\nThe source docs below are kept in this repo for local and offline reference:\n\n1. **[Quick Start](docs/QUICKSTART.md)**\n2. **[Skills](docs/SKILLS.md)**\n3. **[Tools](docs/TOOLS.md)**\n4. **[MCP Integration](docs/MCP.md)**\n5. **[Model Routing](docs/MODEL_ROUTING.md)**\n6. **[Memory](docs/MEMORY.md)** + **[RAG](docs/RAG.md)**\n7. **[Auto Mode](docs/AUTO_MODE.md)** + **[Delayed Actions Design](docs/DELAYED_ACTIONS.md)**\n8. **[Hive Integration](docs/HIVE_INTEGRATION.md)**\n9. **[Webhooks](docs/WEBHOOKS.md)**\n10. **[Deployment](docs/DEPLOYMENT.md)**\n11. **[Dashboard](docs/DASHBOARD.md)**\n\n---\n\n## Contributing / Support / License\n\n- Contributing: see **[CONTRIBUTING.md](CONTRIBUTING.md)** (workflow, quality gates, tests).\n- FAQ: **[FAQ.md](FAQ.md)**.\n- Issues: https://github.com/alexk-dev/golemcore-bot/issues\n- License: **Apache 2.0** — see **[LICENSE](LICENSE)** and **[NOTICE](NOTICE)**.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repo if you find it useful!**\n\nMade with ☕ and 🤖\n\n\u003c/div\u003e\n","funding_links":[],"categories":["2. Agent Framework"],"sub_categories":["1.2 Open Source Projects"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexk-dev%2Fgolemcore-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexk-dev%2Fgolemcore-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexk-dev%2Fgolemcore-bot/lists"}