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.