repowisealishahryar1/free-claude-code

Architecture of alishahryar1/free-claude-code

alishahryar1/free-claude-code is 744 source files holding 9,370 symbols across 5 modules, written mainly in Python, JavaScript, Shell. The largest module is src, with 357 files, and 16 files are entry points into the dependency graph.

How free-claude-code fits together

Requests enter through src/free_claude_code/api/app.py, the FastAPI entry point for the local server. The src/free_claude_code/cli directory owns the command surface, including entrypoints.py and launchers such as launchers/aider.py, which connect a chosen coding agent to that server. The src/free_claude_code/application directory coordinates execution by selecting a provider, handling connected-account access, and running requests through the runtime execution ports. Provider-specific request and response handling lives under src/free_claude_code/providers, for example src/free_claude_code/providers/openai_chat/provider.py. Retries and fallback to the next configured model happen during execution, and optional terminal-output reduction is applied before results go back to the client. The Admin UI is served from src/free_claude_code/api/admin_static, where admin.js is one of the static files.

Largest modules

  • src: 357 files and 56,898 lines of code
  • tests: 312 files and 96,256 lines of code
  • smoke: 43 files and 8,607 lines of code
  • e2e: 15 files and 4,491 lines of code
  • scripts: 3 files and 1,688 lines of code

Languages

By file count: Python 721 files, JavaScript 5 files, Shell 3 files, TypeScript 1 file.

Documentation

Repowise documents free-claude-code in 1,118 pages generated from the source, 37 of them written explanations of the repository and its modules. Module guides include:

  • src/free_claude_code/runtime: ASGI Runtime Bootstrapping
  • src/free_claude_code/config/admin: Admin Configuration State
  • src/free_claude_code/api/admin_static: Admin Static Frontend

More on free-claude-code: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos