Skip to content

Installation

Basic install

pip install bijotel

This gives you the library, CLI, and HMAC chain machinery — enough to seal spans and run bijotel verify.

With extras

BIJOTEL ships modular extras so you only pull what you need.

# REST API + dashboard (FastAPI + uvicorn + python-multipart)
pip install "bijotel[api]"

# Anthropic instrumentor + SDK
pip install "bijotel[anthropic]"

# OpenAI SDK (works with xAI, Together, DeepSeek, etc. via base_url)
pip install "bijotel[openai]"

# Semantic fingerprinting (sentence-transformers, ~1 GB download)
pip install "bijotel[fingerprint]"

# AST code safety (tree-sitter + tree-sitter-bash)
pip install "bijotel[ast]"

# Everything
pip install "bijotel[all]"

# Development (pytest, ruff, build, twine)
pip install "bijotel[dev]"

Requirements

  • Python ≥ 3.11 (tested on 3.11 + 3.12 in CI)
  • No external services (SQLite-based, WAL mode)
  • Works on x86_64 and aarch64 (cross-arch portability validated)

Docker

A minimal Dockerfile ships in the repo:

docker build -t bijotel .
docker run -p 8080:8080 -v ./data:/data bijotel

Verify the install

bijotel --help
python -c "import bijotel; print(bijotel.__version__)"

You should see 2.0.5 (or newer) and the CLI subcommand list: verify, inspect, stats, list, export, verify-export, regression, energy, serve.

Next