Installation

Topos is designed to be accessible as either a standalone binary or by building from source.

Hint

Prerequisites:

• Python 3.11+ is required for core evaluation.

• Rust toolchain (Cargo) is required if building from source.

• If you use the Binary installation, the embedded Python/Rust environments are managed for you.

🚀 Binary CLI (Recommended)

The quickest way to get up and running with the Topos CLI and MCP server.

curl -fsSL https://docs.krv.ai/topos/install.sh | sh

What happens during installation?

1. The latest release binary is downloaded to ~/.local/bin.

2. An embedded Python environment is configured.

3. You will be prompted to optionally install GitNexus (requires Node.js 18+).

Note

Why GitNexus? GitNexus enables Coupling Analysis (the COMPOSABLE lattice target). Without it, Topos performs structural analysis (AST-based) but cannot evaluate inter-module dependencies.

Verify the Installation

topos --version
topos mcp   # prints the FastMCP banner and waits on stdin; Ctrl-C to exit

🐍 Building from Source

If you want to contribute, use the latest development version, or integrate Topos into your Python pipelines:

git clone https://github.com/Krv-Labs/topos.git
cd topos
pip install -e .

Running Tests

To verify the Python and Rust components:

# Run Python tests
pytest

# Run Rust unit tests
cargo test

For coupling analysis of dependency graphs, use the built-in generator:

🛠️ GitNexus Integration

topos depgraph generate

https://github.com/abhigyanpatwari/GitNexus

Removing the binary installation is simple and clean:

🗑️ Uninstallation

topos uninstall

Next Steps

Once installed, proceed to the Quickstart or learn about Concepts to understand the Diamond Lattice evaluation model.