Skip to content

Documentation

Browse Animica docs: consensus (PoIES), data availability, VM (Python), SDKs, ZK, AICF, wallet, explorer, P2P, randomness, and more.

/

Install

pip install animica — the complete client. Everything to mine, run a node, use the wallet, deploy Python contracts, run animica up (the unified miner: PoW + useful-work + GPU train/serve + Studio functions), and use the Studio SDK. The native CPU miner (animica-fastpow) is included by default. This is what most people want.

pip install "animica[all]" — everything above plus every optional extra: Qt desktop-wallet QR codes, the full distributed Studio client (cloudpickle for closures + omni-sdk for on-chain ANM escrow), and all server/operator dependencies pinned. Use it if you want the kitchen sink or are running pool/API infrastructure.

Quote the extras form as pip install "animica[all]" (with quotes) so zsh/macOS does not glob the brackets.

Getting Started

Quickstart: install, connect to a devnet, send your first transaction.

quickstartinstalldevnethello world

Ethereum / EVM RPC

Connect ethers.js, web3.js & MetaMask. eth_*/net_*/web3_* facade on chain id 149, address bridge, honest boundaries.

evmethereummetamaskethers

Bitcoin Core RPC

Point bitcoin-cli, BTCPay & Bitcoin RPC tooling at a node. Bitcoin Core 30.x method names and shapes over Animica.

bitcoinbitcoin-clibtcpayrpc

Mining & animica up

The unified miner: PoW + useful-work + GPU train/serve + Studio functions. Native CPU miner included by default.

mininganimica upfastpowcpu

Studio SDK

Serverless compute SDK: @app.function, .remote()/.map(), images, secrets, volumes, GPUs — settled in ANM.

studioserverlesssdkmodal

Consensus — PoIES

Proof-of-Integrated-External-Services (ψ mapping, Θ retarget, fairness, Γ caps).

consensuspoiesthetafairness

Data Availability (DA)

Blob commitments, namespaced Merkle trees (NMT), erasure coding, light verification.

dablobsnmterasure

VM (Python)

Deterministic Python VM: ABI, gas, stdlib, examples (Counter, Escrow).

vmpythonabigas

SDKs

Python, TypeScript, and Rust SDKs with codegen and E2E harness. Python ships as pip install animica.

sdkpythontypescriptrust

ZK Verifiers

Groth16/PLONK/STARK basics, Poseidon, KZG, VK pinning & policy hooks.

zkgroth16plonkstark

AI Compute Fund (AICF)

Job queue, provider registry, attestations, SLA, pricing & settlement.

aicfaiquantumsla

AICF Compute Dashboard

Live AI-compute lane: submit jobs and track providers. Want to provide compute? See /providers.

aicfcomputedashboardproviders

Randomness Beacon

Commit–reveal, VDF, optional QRNG mixing, light proofs.

randomnessvdfqrngbeacon

P2P & Gossip

Handshake (Kyber), transports (TCP/QUIC/WS), gossip topics, sync flows.

p2pquicgossipsync

Wallet & Provider

Extension keys (Dilithium/SPHINCS+), provider API, simulation. Downloads on /wallet.

walletproviderpqmv3

Explorer & Studio

Explorer views and APIs. The hosted Studio web IDE is being rebuilt; a Linux desktop build is on /studio.

studioexplorerideverify

Operations & Devnet

Run a node, metrics, logging, configs, fixtures and testnets.

opsnodedevnetmetrics

Can’t find what you’re looking for? Browse the full docs tree on GitHub , open an issue on GitHub , or become a compute provider via /providers .