Install¶

Install CodeFreedom and get started in five minutes.

Prerequisites¶

Python 3.10+ — for the CLI
Docker — for proxy and sandbox containers
Docker Compose — for multi-container setups

Install¶

pip install codefreedom

Or install from source:

git clone https://github.com/nilayparikh/codefreedom.git
cd codefreedom
pip install -e .

Verify¶

cf --help
# or
cf -h

You should see:

usage: codefreedom [-h] {setup,run,manage} ...

Unified CLI for code agents.
LLM proxy routing, Docker sandboxing, profile management.

commands:
  setup (s)           One-time setup and configuration (init, config, deinit)
  run (r)             Daily workflows (agent, proxy, tools)
  manage (m)          Occasional maintenance (doctor, update, admin)

Quick Start¶

cf setup init                    # Set up config
cf run proxy start               # Start the proxy
cf run agent claude-code         # Launch Claude Code

Or with short aliases:

cf s i                           # cf setup init
cf r px start                    # cf run proxy start
cf r ag cc                       # cf run agent claude-code

Next Steps¶

First Run — step-by-step walkthrough
Agents — launch coding agents
Proxy — self-hosted LiteLLM proxy
Tools — browser and API tools