HUB
Sign inSign up

pixan/agent-kernel

By pixan

•Updated 1 day ago

Base for a Claude Code-based 24/7 personal agent on Telegram. Claude Code is not included.

Image
Machine learning & AI
0

451

pixan/agent-kernel repository overview

⁠agent-kernel (base image)

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⁠

⁠What this image is, and what it is not

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.

⁠Run an agent

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⁠

⁠Tags

  • 1.1.0: an exact release. 1.1: the latest 1.1.x. Earlier: 1.0.0.
  • For production, pin by digest: pixan/agent-kernel@sha256:…
  • The same image, same digest, is also at ghcr.io/pixan-ai/agent-kernel.

⁠Verify it

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

⁠Security

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⁠

⁠License

Apache-2.0. The third-party software in the image and its licenses are listed in /usr/share/doc/agent-kernel/THIRD-PARTY.md.

Tag summary

Content type

Image

Digest

sha256:17f90fa10…

Size

399 MB

Last updated

1 day ago

docker pull pixan/agent-kernel