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
1 maintainer
Release files for animica 10.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| animica-10.4.0.tar.gz | 8.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| animica-10.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.1 MB
Release files / animica-10.4.0.tar.gz
| Download URL | animica-10.4.0.tar.gz |
|---|---|
| Size | 8.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fae414472766a6667cabedf502c6e1de52bf7c221e5095807095579d48e1ca99
|
|
BLAKE2b-256 checksum How to use checksums |
14a172b3c6b84f0f41e15228d17eac5ae3a07e0f5acc5d482d9211aa5e663c6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / animica-10.4.0-py3-none-any.whl
| Download URL | animica-10.4.0-py3-none-any.whl |
|---|---|
| Size | 8.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d2c6479e2bdc1b2dc1f5b4cd3e3f7d25ac9e41d95e3476616a721f069fa7d32b
|
|
BLAKE2b-256 checksum How to use checksums |
2e1976acff2485429e8745c67363a94375c3c062181d713ca2261ffbab6608ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
