Open Source Java 17+ Apache 2.0

AI Agent Framework
for Java

Skill-based architecture with MCP support, tool calling, RAG, and Telegram integration.
Built on Spring Boot and LangChain4j.

View on GitHub Get Started 
// 1. Pull
docker pull ghcr.io/alexk-dev/golemcore-bot:latest

// 2. Run
docker run -d \
  -e OPENAI_API_KEY=sk-... \
  -e TELEGRAM_ENABLED=true \
  -e TELEGRAM_BOT_TOKEN=... \
  ghcr.io/alexk-dev/golemcore-bot:latest
775
Tests Passing
9
Built-in Tools
11
Pipeline Stages
3
LLM Providers

Key Features

Everything you need to build intelligent AI agents in Java

Hybrid Skill Routing

2-stage semantic search + LLM classifier (~5ms + 200ms). Automatic intent matching with fragmented input detection.

MCP Protocol

Model Context Protocol support for stdio-based tool servers. Connect GitHub, Slack, Google Drive and more out of the box.

9 Built-in Tools

Filesystem, Shell, Web Search, Browser, Weather, Skill Management, Goals, Transitions, and DateTime — all sandboxed.

Multi-LLM Support

OpenAI, Anthropic (Claude), Google (Gemini), and custom OpenAI-compatible endpoints. Dynamic model tier selection.

RAG Integration

LightRAG for long-term memory via knowledge graphs. Automatic indexing and semantic retrieval across conversations.

Auto Mode

Autonomous goal-driven execution. The agent plans tasks, executes them, writes diary entries, and sends milestone updates.

Processing Pipeline

Messages flow through 11 ordered systems with up to 20 tool-call iterations

10
InputSanitization HTML sanitization, length check
15
SkillRouting Hybrid skill matching
18
AutoCompaction Context overflow prevention
20
ContextBuilding Prompt assembly, MCP startup
25
DynamicTier Coding activity detection
30
LlmExecution LLM API call with retry
40
ToolExecution Tool calls + user confirmation
50
MemoryPersist Conversation persistence
55
RagIndexing Long-term memory indexing
57
SkillPipeline Auto-transitions
60
ResponseRouting Send response to user

Tech Stack

Java 17+
Spring Boot 3.4
LangChain4j
Telegram Bots API
Playwright
Feign + OkHttp
JUnit 5
Docker / Jib

Quick Start

Get running in under 5 minutes

Docker (Recommended)
# Configure and run
export OPENAI_API_KEY=sk-proj-...
docker run -d \
  --name golemcore-bot \
  -e OPENAI_API_KEY \
  -v golemcore-bot-data:/app/workspace \
  -p 8080:8080 \
  --restart unless-stopped \
  ghcr.io/alexk-dev/golemcore-bot:latest
JAR
# Build
./mvnw clean package -DskipTests

# Configure
export OPENAI_API_KEY=sk-proj-...

# Run
java -jar target/golemcore-bot-0.1.0-SNAPSHOT.jar
With Telegram
# Add Telegram env vars
export TELEGRAM_ENABLED=true
export TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
export TELEGRAM_ALLOWED_USERS=123456789

Get Involved

GolemCore Bot is open source under Apache 2.0. Contributions, issues, and stars are welcome.

GitHub Wiki Issues Discussions