nilayparikh/codefreedom repository overview

Pre-built container images for CodeFreedom⁠ — a unified CLI that orchestrates code agents through publicly supported interfaces (environment variables, CLI flags, API endpoints). No patching, no reverse-engineering.

⁠Image Index

⁠Quick Start

Claude Code sandbox (CPU):

docker pull docker.io/nilayparikh/codefreedom:ubuntu-latest

Claude Code sandbox (NVIDIA GPU):

docker pull docker.io/nilayparikh/codefreedom:cuda-latest

Headless Chrome for code agents:

docker pull docker.io/nilayparikh/codefreedom:chrome-latest

Camoufox web automation (MCP):

docker pull docker.io/nilayparikh/codefreedom:camoufox-latest

⁠What's Inside

⁠Claude Code Images (ubuntu-*, cuda-*, rocm-*)

• Claude Code CLI with full profile support
• Python 3, Node.js, and essential dev tools
• ubuntu-*: Multi-arch (ARM64 + AMD64), no AI frameworks
• cuda-*: NVIDIA CUDA toolkit for PyTorch inference
• rocm-*: AMD ROCm stack for PyTorch inference

⁠Chrome Image (chrome-*)

• Google Chrome Stable (retail build) — not the Ubuntu snap
• Xvfb at 1920×1080×24 for realistic fingerprint
• PulseAudio, rich font inventory (MS Core Fonts + CJK + emoji)
• Exposes CDP on port 9222 for agent connection

⁠Camoufox Image (camoufox-*)

• Camoufox (Firefox fork without CDP) — presents a standard Firefox profile
• MCP Streamable HTTP server on port 8420
• Two tools: web_search (Brave + Bing) and web_fetch (anti-bot page fetch)
• Persistent browser profile for session continuity

⁠Architecture

All images follow the CodeFreedom pattern: containers run a long-lived idle process (sleep infinity or MCP server), and agents are docker exec'd into them. Workspace directories are mounted read-write, with ~/.gitconfig and ~/.ssh mounted read-only.

⁠Mirrors

Images are published to both docker.io/nilayparikh/codefreedom and ghcr.io/nilayparikh/codefreedom.

⁠License

Apache 2.0 — nilayparikh/codefreedom⁠