Skip to content

Installation

uv is the recommended package manager for Python projects.

uv add agenticraft-foundation

Install with pip

pip install agenticraft-foundation

Verify installation

python -c "import agenticraft_foundation; print(agenticraft_foundation.__version__)"

This should print the installed version (e.g., 0.1.0).

Requirements

  • Python 3.10+
  • Minimal runtime dependencies -- requires only NumPy for spectral analysis and probabilistic verification. Core CSP, MPST, and protocol modules are pure Python.

Development setup

For contributors who want to run tests and work on the codebase:

# Clone the repository
git clone https://github.com/agenticraft/agenticraft-foundation.git
cd agenticraft-foundation

# Install with development dependencies
uv sync --group dev

# Verify the test suite passes
uv run pytest tests/ -v

The full test suite (1,350+ tests) should complete in under a minute on most machines. All tests run without network access or external services.

Dev Container (VS Code / GitHub Codespaces)

The repository includes a Dev Container configuration for a zero-setup development environment. It comes pre-configured with Python 3.12, uv, Ruff, and mypy.

VS Code:

  1. Install the Dev Containers extension
  2. Open the repository in VS Code
  3. Click "Reopen in Container" when prompted (or run Dev Containers: Reopen in Container from the command palette)

Dependencies install automatically. Format-on-save is enabled with Ruff.

GitHub Codespaces:

Click the green "Code" button on the repository and select "Open with Codespaces". The dev container configuration is picked up automatically.

Docker (manual):

docker build -t agenticraft-foundation .devcontainer/
docker run -it -v $(pwd):/workspace agenticraft-foundation bash