Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python
5.3 KB
Raw Blame
[build-system]
requires = ["hatchling", "hatch-vcs>=0.5.0"]
build-backend = "hatchling.build"

[project]
name = "free-claude-code"
dynamic = ["version"]
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
license = "AGPL-3.0-only"
license-files = ["LICENSE"]
requires-python = "==3.14.7"
dependencies = [
    "packaging>=26.3",
    "anyio>=4.15.1",
    "fastapi[standard]>=0.141.1",
    "uvicorn>=0.54.0",
    "httpx[socks]>=0.28.1",
    "httpx2[socks]>=2.7.0,<3",
    "markdown-it-py>=4.2.0",
    "pydantic>=2.14.1",
    "python-dotenv>=1.2.4",
    "tiktoken>=0.13.0",
    "python-telegram-bot>=22.8",
    "discord.py>=2.7.1",
    "openai>=3.29.0",
    "loguru>=0.7.0",
    "aiohttp>=3.14.5",
    "jsonschema>=4.25.0",
    "json5>=0.17.3",
    "tomlkit>=0.13.3",
    "google-auth[requests]>=2.56.3",
    "requests[socks]>=2.34.2",
    "pystray>=0.19.5; sys_platform == 'win32' or sys_platform == 'darwin'",
    "Pillow>=12.0.0; sys_platform == 'win32' or sys_platform == 'darwin'",
    "github-copilot-sdk>=1.0.21",
    "simplejson>=4.2.0",
    "grpcio>=1.84.0",
    "grpcio-tools>=1.81.1",
    "nvidia-riva-client>=2.26.0",
    "pyperclip>=1.11.0",
    "sqlalchemy>=2.1.4",
    "ruamel-yaml>=0.19.1",
]

[project.scripts]
_fcc-update-check = "free_claude_code.updater.check:main"
fcc-server = "free_claude_code.cli.entrypoints:serve"
fcc-doctor = "free_claude_code.cli.entrypoints:doctor"
fcc-claude = "free_claude_code.cli.launchers.claude:launch"
fcc-codex = "free_claude_code.cli.launchers.codex:launch"
fcc-pi = "free_claude_code.cli.launchers.pi:launch"
fcc-opencode = "free_claude_code.cli.launchers.opencode:launch"
fcc-cline = "free_claude_code.cli.launchers.cline:launch"
fcc-hermes = "free_claude_code.cli.launchers.hermes:launch"
fcc-dsh = "free_claude_code.cli.launchers.dsh:launch"
fcc-grok = "free_claude_code.cli.launchers.grok:launch"
fcc-muse = "free_claude_code.cli.launchers.muse:launch"
fcc-aider = "free_claude_code.cli.launchers.aider:launch"

[project.gui-scripts]
fcc-desktop = "free_claude_code.cli.desktop_entrypoint:launch"

[project.optional-dependencies]
voice_local = [
    "torch>=2.14.1",
    "transformers>=5.19.0",
    "accelerate>=1.15.0",
    "librosa>=1.0.0",
]

[tool.hatch.version]
source = "vcs"

[tool.hatch.build]
artifacts = ["src/free_claude_code/assets/macos/fcc-desktop-*"]

[tool.hatch.build.targets.wheel]
packages = ["src/free_claude_code"]

[tool.hatch.build.targets.wheel.shared-scripts]
"scripts/update/fcc-update" = "fcc-update"
"scripts/update/fcc-update.cmd" = "fcc-update.cmd"

[tool.uv]
required-version = ">=0.13.4"
cache-keys = [{ file = "pyproject.toml" }, { git = { commit = true, tags = true } }]

[tool.uv.sources]
torch = { index = "pytorch-cu130" }

[[tool.uv.index]]
name = "pytorch-cu130"
url = "https://download.pytorch.org/whl/cu130"
explicit = true

[dependency-groups]
dev = [
    "pytest>=9.1.1",
    "pytest-asyncio>=1.4.0",
    "pytest-cov>=7.1.0",
    "ty>=0.0.86",
    "ruff>=0.17.0",
    "pytest-xdist>=3.8.0",
    "pytest-playwright>=0.10.0",
    "pyyaml>=6.0.3",
    "pytest-split>=0.11.0",
]

[tool.ruff]
target-version = "py314"
line-length = 88

[tool.ruff.lint]
select = [
    "E",    # pycodestyle errors
    "W",    # pycodestyle warnings
    "F",    # Pyflakes (undefined names, unused imports)
    "I",    # isort (import ordering)
    "UP",   # pyupgrade (modernise syntax for target Python version)
    "B",    # flake8-bugbear (common bugs and anti-patterns)
    "C4",   # flake8-comprehensions (idiomatic comprehensions)
    "SIM",  # flake8-simplify (simplifiable code patterns)
    "PERF", # Perflint (performance anti-patterns)
    "RUF",  # Ruff-specific rules
]
ignore = [
    "E501",  # line too long — enforced by the formatter instead
    "B008",  # FastAPI Depends() in argument defaults is intentional
    "RUF006",  # fire-and-forget tasks intentionally not awaited
]

[tool.ruff.lint.isort]
known-first-party = ["free_claude_code", "smoke"]

[tool.ruff.format]
quote-style = "double"
indent-style = "space"
line-ending = "auto"
skip-magic-trailing-comma = false

[tool.pytest.ini_options]
pythonpath = ["src", "."]
addopts = "-p e2e.thread_diagnostics -n auto --dist=worksteal"
tmp_path_retention_policy = "failed"
filterwarnings = [
    "error",
    # Starlette's test client uses this deprecated alias, including in 1.6.0.
    'ignore:^The anyio\.abc\.BlockingPortal alias is deprecated, use anyio\.from_thread\.BlockingPortal instead\.$:DeprecationWarning:^starlette\.testclient$',
]
testpaths = ["tests"]
markers = [
    "live: opt-in local smoke tests that can touch real services",
    "interactive: smoke tests requiring manual user interaction",
    "provider: live provider checks",
    "messaging: live messaging platform checks",
    "cli: CLI integration checks",
    "clients: client compatibility checks",
    "voice: voice transcription checks",
    "contract: deterministic feature contract checks",
    "smoke_target(name): route a smoke test behind FCC_SMOKE_TARGETS",
    "xdist_group(name): group smoke provider items under pytest-xdist --dist=loadgroup",
]

[tool.ty.environment]
python-version = "3.14"

[tool.ty.analysis]
# Optional voice_local extra: torch, transformers, librosa for local whisper transcription
allowed-unresolved-imports = [
    "torch",
    "transformers",
    "librosa",
    "pystray",
    "PIL",
]