Krill.jl

Appearance

Krill.jlPersonal AI assistant runtime in Julia

🦐 A tiny Julia framework for building personal AI assistants across chat platforms, inspired by OpenClaw and nanobot.

Get Started
Read the Architecture
Browse the API

Agents

Session orchestration, tool-calling loop, and background subagent spawning — the core intelligence that drives every conversation.

Tools & MCP

File ops, web search, GitHub, shell exec, cron scheduling, and external MCP servers — all registered into one tool surface.

Skills

Markdown instruction documents that shape assistant behavior. Always-on or on-demand, with dependency checks.

LLM Providers

OpenAI Responses and Gemini native, with provider-side web search, code execution, and context-window management.

Context & Memory

Prompt context, bootstrap docs, session history, durable memory files, and LLM-driven consolidation for lasting context.

Channels

Telegram polling, webhooks, and Discord gateway. Thin adapters that normalize platform events into a shared message contract.

Runtime

Message hub, dispatch queue, retry policies, dead letters, deduplication, and durable queue primitives that keep the pipeline reliable.

Security

Per-channel allow_from allowlists, exec denylist + URL scan, SSRF protection with DNS resolution and redirect validation, and symlink-safe workspace sandboxing.

Current Scope ​

Agent API
Agent, AgentHooks, RetryConfig — composable, testable, flat-kwarg and struct-based entry points
Agent Capabilities
Built-in tools, provider-native tools, MCP, skills, cron, subagents, prompt context, memory consolidation, history summarization
LLM Providers
OpenAI Responses API · Gemini native generateContent · Gemini OpenAI-compat — with web search, code execution, and URL context
Memory
Per-session LLM-consolidated memory + cross-channel global user profile via /remember
Persistence
Session history JSONL, memory files, cron job JSON, dead letters, durable queue WAL
Channels
Telegram polling, Telegram webhook server, Discord Gateway + REST
Entry Point
bin/krill.jl — channel selection driven entirely by krill.toml, no code changes needed