Skip to main content

Install

ANIP is available across multiple ecosystems. Pick your language to get started.

CLI

The ANIP CLI is distributed from GitHub release assets as prebuilt archives for macOS, Linux, and Windows:

anip version
anip generate --help
anip validate --help

Each release includes:

  • anip_<version>_darwin_amd64.tar.gz
  • anip_<version>_darwin_arm64.tar.gz
  • anip_<version>_linux_amd64.tar.gz
  • anip_<version>_linux_arm64.tar.gz
  • anip_<version>_windows_amd64.zip
  • anip_<version>_windows_arm64.zip
  • anip_<version>_checksums.txt
  • anip.rb Homebrew formula for anip-protocol/homebrew-anip tap installation

The primary command is anip. Compatibility wrappers anip-generate and anip-verify are included in the macOS/Linux archives and formula. Windows archives include anip.exe, anip-generate.cmd, and anip-verify.cmd.

Homebrew installation uses the separate anip-protocol/homebrew-anip tap:

brew tap anip-protocol/anip
brew install anip

Runtime packages

Published to PyPI. Install the service runtime and a framework adapter:

pip install anip-service anip-fastapi

All published packages:

PackagePurpose
anip-coreModels, types, constants
anip-cryptoKey management, JWT, signing
anip-serverProtocol engine (delegation, audit, checkpoints)
anip-serviceService runtime (capabilities, handlers)
anip-fastapiFastAPI framework adapter
anip-restREST / OpenAPI interface adapter
anip-graphqlGraphQL interface adapter
anip-mcpMCP Streamable HTTP interface adapter
anip-stdiostdio transport (JSON-RPC 2.0)
anip-grpcgRPC transport

Studio

Studio runs as standalone Docker services. Treat it as the design and package-authoring application, not as a runtime adapter that every service mounts.

Standalone local compose with Postgres:

cd studio
docker compose up --build

Read-only seeded demo mode:

STUDIO_READ_ONLY=1 STUDIO_SEED_SHOWCASES=1 docker compose up --build

Direct standalone image build:

docker build -t anip-studio studio/
docker run -p 3000:8080 anip-studio

Testing tools

# Conformance suite — validates protocol compliance
pip install -e ./conformance
pytest conformance/ --base-url=http://localhost:9100 --bootstrap-bearer=demo-human-key

# Contract testing — validates behavioral truthfulness
pip install -e ./contract-tests
anip-contract-tests --base-url=http://localhost:9100 --test-pack=contract-tests/packs/travel.json

For the full artifact story, see What Ships Today.