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.gzanip_<version>_darwin_arm64.tar.gzanip_<version>_linux_amd64.tar.gzanip_<version>_linux_arm64.tar.gzanip_<version>_windows_amd64.zipanip_<version>_windows_arm64.zipanip_<version>_checksums.txtanip.rbHomebrew formula foranip-protocol/homebrew-aniptap 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
- Python
- TypeScript
- Go
- Java
- C#
Published to PyPI. Install the service runtime and a framework adapter:
pip install anip-service anip-fastapi
All published packages:
| Package | Purpose |
|---|---|
anip-core | Models, types, constants |
anip-crypto | Key management, JWT, signing |
anip-server | Protocol engine (delegation, audit, checkpoints) |
anip-service | Service runtime (capabilities, handlers) |
anip-fastapi | FastAPI framework adapter |
anip-rest | REST / OpenAPI interface adapter |
anip-graphql | GraphQL interface adapter |
anip-mcp | MCP Streamable HTTP interface adapter |
anip-stdio | stdio transport (JSON-RPC 2.0) |
anip-grpc | gRPC transport |
Published to npm under the @anip scope. Install the service runtime and a framework adapter:
npm install @anip-dev/service @anip-dev/hono
All published packages:
| Package | Purpose |
|---|---|
@anip-dev/core | Models, types, constants |
@anip-dev/crypto | Key management, JWT, signing |
@anip-dev/server | Protocol engine |
@anip-dev/service | Service runtime |
@anip-dev/hono | Hono framework adapter |
@anip-dev/express | Express framework adapter |
@anip-dev/fastify | Fastify framework adapter |
@anip-dev/rest | REST / OpenAPI interface adapter |
@anip-dev/graphql | GraphQL interface adapter |
@anip-dev/mcp | MCP shared core |
@anip-dev/mcp-hono | MCP adapter for Hono |
@anip-dev/mcp-express | MCP adapter for Express |
@anip-dev/mcp-fastify | MCP adapter for Fastify |
@anip-dev/stdio | stdio transport (JSON-RPC 2.0) |
Consumed as a Go module via version tags:
go get github.com/anip-protocol/anip/packages/go@vVERSION
Packages in the module:
core, crypto, server, service, httpapi, ginapi, restapi, graphqlapi, mcpapi, stdioapi, grpcapi
Published to Maven Central under group dev.anip:
<dependency>
<groupId>dev.anip</groupId>
<artifactId>anip-service</artifactId>
<version>0.24.4</version>
</dependency>
All published modules:
| Module | Purpose |
|---|---|
anip-core | Models, types |
anip-crypto | Key management, JWT |
anip-server | Protocol engine |
anip-service | Service runtime |
anip-spring-boot | Spring Boot adapter |
anip-quarkus | Quarkus adapter |
anip-rest / anip-rest-spring / anip-rest-quarkus | REST adapters |
anip-graphql / anip-graphql-spring / anip-graphql-quarkus | GraphQL adapters |
anip-mcp / anip-mcp-spring / anip-mcp-quarkus | MCP adapters |
anip-stdio | stdio transport |
C# packages are published by the release workflow to NuGet:
dotnet add package Anip.Service --version 0.24.4
dotnet add package Anip.AspNetCore --version 0.24.4
All projects: Anip.Core, Anip.Crypto, Anip.Server, Anip.Service, Anip.AspNetCore, Anip.Rest, Anip.Rest.AspNetCore, Anip.GraphQL, Anip.GraphQL.AspNetCore, Anip.Mcp, Anip.Mcp.AspNetCore, Anip.Stdio
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.