Installation
BrightVision Core is a biforkation (fork²): Cecli → Cecli → this repo, with bright_vision_core/ ported from our earlier engine. Product support: BrightVision. Cecli terminal community: cecli.dev. Upstream Cecli docs also live under cecli/website/ in the repository — not overwritten.
Quick start
Install the engine package, then run the CLI or HTTP server.
python -m pip install -U bright-vision-core
# Change directory into your git workspace
cd /path/to/your/project
# CLI
cecli --model sonnet --api-key anthropic=<key>
# Or headless HTTP API (from repo root)
bright-vision-core-serve --workspace /path/to/your/project
For the BrightVision desktop app, use bright-vision.digitaldefiance.org — it talks to this engine over HTTP.
Optional: optional install steps. Usage details for the shared engine: Usage and upstream usage.
The upstream cecli.dev install.sh flow installs Cecli, not this package — use pip install bright-vision-core for Vision Core.
One-liners (upstream Cecli)
These install cecli from cecli.dev (not bright-vision-core).
For Vision Core use pip install bright-vision-core above.
Based on uv.
Mac & Linux
Use curl to download the script and execute it with sh:
curl -LsSf https://cecli.dev/install.sh | sh
If your system doesn’t have curl, you can use wget:
wget -qO- https://cecli.dev/install.sh | sh
Windows
powershell -ExecutionPolicy ByPass -c "irm https://cecli.dev/install.ps1 | iex"
Install with uv
Install bright-vision-core (includes cecli + bright-vision-core-serve) with uv:
python -m pip install uv # If you need to install uv
uv tool install --force --python python3.12 --with pip bright-vision-core@latest
This will install uv using your existing python version 3.8-3.13, and use it to pip install bright-vision-core. If needed, uv will automatically install a separate python 3.12 to use with cecli.
Also see the docs on other methods for installing uv itself.
Install with pipx
Install with pipx:
python -m pip install pipx # If you need to install pipx
pipx install bright-vision-core
Python 3.9–3.12 supported.
Also see the docs on other methods for installing pipx itself.
Other install methods
Other methods below; prefer pip install bright-vision-core for this package.
Install with pip
If you install with pip, you should consider using a virtual environment to keep cecli’s dependencies separated.
Python 3.9–3.12:
python -m pip install -U --upgrade-strategy only-if-needed bright-vision-core
In some environments you may get “cecli command not found” errors.
You can try python -m cecli or
see here for more info.
Installing with package managers
Prefer PyPI bright-vision-core for this repo.
Third-party distro packages may target upstream cecli only.
Next steps…
There are some optional install steps you could consider. See the usage instructions to start coding with cecli.