Base for a Claude Code-based 24/7 personal agent on Telegram. Claude Code is not included.
451
A Claude Code-based 24/7 personal agent on Telegram in one container, using only official components: the Claude Code harness, the official Telegram channel plugin and a managed policy file. Memory, scheduled jobs, groups and fellow agents, with less than 300 lines of Bash.
Source, docs and issues: https://github.com/pixan-ai/agent-kernel
This is the base image: Debian, the tools an agent uses (Python with uv, Typst, markitdown, pandoc, poppler, rclone, age, supercronic), the managed policy and the scripts.
It does not contain Claude Code or the Telegram plugin. Claude Code is Anthropic's software, used under Anthropic's terms, so it is never redistributed here: your own build installs it on your host with the official installer. CI checks every published image for that.
The simplest way: one click on Railway, https://railway.com/deploy/pixan-agent
Or build it from the repository, which adds Claude Code on top of this base:
git clone https://github.com/pixan-ai/agent-kernel.git
cd agent-kernel
cp .env.example .env # your bot token, your Telegram id, your Claude credential
docker compose up -d --build
Step by step, from nothing to an agent that answers: https://github.com/pixan-ai/agent-kernel/blob/main/docs/GETTING-STARTED.md
On your own Linux server: https://github.com/pixan-ai/agent-kernel/blob/main/docs/DEPLOY-LINUX.md
1.1.0: an exact release. 1.1: the latest 1.1.x. Earlier: 1.0.0.pixan/agent-kernel@sha256:…ghcr.io/pixan-ai/agent-kernel.Every release is scanned (no fixable critical vulnerability), signed with cosign (keyless, from the release workflow) and ships an SBOM and SLSA provenance. Version tags are added only after all of that passed.
cosign verify pixan/agent-kernel:1.1.0 \
--certificate-identity-regexp '^https://github.com/pixan-ai/agent-kernel/\.github/workflows/release\.yml@refs/tags/v.+$' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
OpenSSF Best Practices: passing (https://www.bestpractices.dev/projects/16964). Report vulnerabilities privately: https://github.com/pixan-ai/agent-kernel/security/advisories/new
What it protects and what it does not: https://github.com/pixan-ai/agent-kernel/blob/main/docs/THREAT-MODEL.md
Apache-2.0. The third-party software in the image and its licenses are listed in /usr/share/doc/agent-kernel/THIRD-PARTY.md.
Content type
Image
Digest
sha256:17f90fa10…
Size
399 MB
Last updated
1 day ago
docker pull pixan/agent-kernel