agentic-factory

Infrastructure, container images, and reusable GitHub Actions for autonomous AI agents.

What This Is

A toolbox repo that provides the foundation for running AI agents. Agents themselves live in other repos — this repo builds:

• Container images — layered Docker images with common dev tools + AI CLI tools (Claude Code, OpenCode, pi-coding-agent)
• Shared composite action — reusable GitHub Action that any agent repo can reference
• Infrastructure provisioning — Ansible playbooks for setting up self-hosted runners on Hetzner Cloud or MacBook
• Agent tooling — Python package with CLI tools for agent communication (Discord notifications, etc.)

Quick Start

Using the Container Images

# In your agent repo's workflow:
jobs:
  agent:
    runs-on: [self-hosted, claude-agent]
    container:
      image: ghcr.io/ondrasek/agent-runtime-claude:latest
      env:
        CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
    steps:
      - uses: actions/checkout@v4
      - uses: ondrasek/agentic-factory/.github/actions/run-agent@main
        with:
          tool: claude-code
          prompt: "Review this PR for issues"
          post-to: pr
          post-number: ${{ github.event.pull_request.number }}

Available Images

Discord Notifications

Agents can post to Discord using the af-discord CLI (included in all images):

af-discord send --channel agent-results "Code review complete for PR #42"
af-discord send --channel agent-results --title "Agent: Reviewer" --status success "LGTM"

Development

uv sync
uv run pytest
uv run ruff check .

License

MIT