Install and run CoderAI

Quick start

The repository quick start builds all backends, activates the virtual environment, then starts the server on http://127.0.0.1:8776.

git clone git@git.nexlab.net:nexlab/coderai.git
cd coderai
./build.sh all
source venv_all/bin/activate
python coderai

First login: open http://127.0.0.1:8776/admin, log in with admin / admin, then change the credentials and create real API tokens.

Prefer containers?

Download coderai-docker-dist.tar, the ready-to-use Docker install bundle. It includes install.sh, the coderai-docker run wrapper, coderai-dist.tar.gz containing the prebuilt Docker image, and README files. Run install.sh, then start it with coderai-docker; use it when you want immutable app code with persistent /config, /models, and /cache mounts.

Install with Docker / OCI

Platform build commands

Linux

./build.sh all      # all backends
./build.sh nvidia   # NVIDIA CUDA only
./build.sh vulkan   # AMD/Intel Vulkan path

macOS

./osxbuild.sh all
source venv_osx_all/bin/activate
python coderai

macOS uses Metal/MPS paths where available; CUDA is not a general macOS route.

Windows PowerShell

.\build.ps1 -Backend all
.\venv_win_all\Scripts\Activate.ps1
python coderai

Prerequisites and packaging

Python 3.8+.
NVIDIA: CUDA toolkit / matching driver support; CUDA 11.8+ is recommended in the README.
AMD/Intel: Vulkan drivers and SDK.
CPU-only: no GPU driver required, but heavy media generation will be slow.

./build.sh all --package
./osxbuild.sh all --package
.\build.ps1 -Backend all -Package

Packaging outputs include Linux dist-package/coderai, macOS dist-package/coderai plus CoderAI.app, and Windows dist-package/coderai.exe. Packaged builds still need compatible external GPU/runtime drivers.

Access points and local files

Path	Purpose
`/admin`	Admin dashboard, users, tokens, settings, model management.
`/chat`	Web Studio for generation tasks.
`/v1/*`	OpenAI-compatible and native multimodal API routes.
`/docs`, `/redoc`	Interactive FastAPI documentation and schema browser.

Runtime state is configuration-first under ~/.coderai/, including config.json, models.json, auth.json, pipelines.json, archive paths, and generated secrets.