Animica Python toolbox

This directory packages the Python utilities that live under animica/, including data-availability helpers, mempool policy tests, and the stratum pool prototype. Installing it as a Python package allows tools and tests elsewhere in the repo to import animica modules directly.

Mine & earn — one command

pip install --upgrade animica

# Runs EVERYTHING, bound to your Animica address (auto-creates a wallet if you
# have none): SHA3 mining + ENA useful-work, plus model training + serving on a
# GPU, plus Bittensor serving on a qualified GPU (>=16 GB VRAM). Joins the pool
# and the one global model. Every reward — PoW, useful-work, training, serving,
# Bittensor — pays out in ANM to your address.
animica up

animica up --plan          # show exactly what will run on this machine first
animica up --pool-host pool.animica.org --pool-id <pool>   # target a pool

animica up advertises miner version 1.0.0; the pool rejects older miners, so keep it upgraded. Qualified GPUs (>=16 GB VRAM) also serve Bittensor, with all earnings bound to ANM (no external TAO/XMR payout). Full details: https://pool.animica.org/mining-onboard

Component commands (advanced — animica up runs these for you)

animica miner dual-mine <anm-address> --pool-host pool.animica.org  # PoW only
animica ena worker start --worker-id <id>                           # useful-work
animica ena pool serve <pool-id> --worker-id <id>                   # serve a model
animica bittensor overview                                          # Bittensor pool status

Installation

From the repository root you can install the package in editable mode:

python -m pip install -e "python[operator,dev]"

Optional extras

Base package: now includes the backend runtime dependencies required by rpc.server, the ENA node, and the Stratum pool (fastapi, uvicorn[standard], prometheus-client).
backend, ena, stratum, operator: compatibility aliases kept for operator/install scripts and older docs. They resolve to the same runtime dependency set as the base package.
dev: pytest, mypy, ruff, respx, and other local development tools.

Example with extras:

python -m pip install -e "python[stratum,dev]"

Stratum pool runtime

Preferred operator path:

animica stratum up --daemon --profile asic_sha256 --rpc-url http://127.0.0.1:8545/rpc
animica stratum status
animica stratum down

Lower-level entrypoint:

python -m animica.stratum_pool --profile asic_sha256

Validation helpers

The repo now ships executable smoke helpers for the repaired setup/runtime path:

./scripts/smoke_backend_imports.sh
./scripts/smoke_ena.sh
./scripts/smoke_stratum.sh
./scripts/smoke_setup_install.sh

Release files for animica 10.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for animica 10.3.1
File	Interpreter	ABI	Platform	Reset
animica-10.3.1-py3-none-any.whl 9.2 MB Aug 17, 2026	Python 3	none	any	Details

Release files / animica-10.3.1-py3-none-any.whl

Download URL	animica-10.3.1-py3-none-any.whl
Size	9.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`79e70ee85c4f061d487fe2cef74ff4dd6705c2c27a6e21229ae4dfdf5c83e0be`
BLAKE2b-256 checksum How to use checksums	`3228cea9ea422a23d81a65989baa9724c13e17e2c1ca80b9fc24cdaf262d1a15`
Upload date	Aug 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`