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.1
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.1.tar.gz | 8.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| animica-10.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.1 MB
Release files / animica-10.4.1.tar.gz
| Download URL | animica-10.4.1.tar.gz |
|---|---|
| Size | 8.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
22b716e2647d369a46a41073483a9823357308e43e1c7e3e9a18243af06fc7d6
|
|
BLAKE2b-256 checksum How to use checksums |
f032f43f7bd7d443ff1cf0a8d157392f465c1e5add1cd38dff5ad010db43c922
|
| 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.1-py3-none-any.whl
| Download URL | animica-10.4.1-py3-none-any.whl |
|---|---|
| Size | 8.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0ee31c24dcf9ec4420c1800a737660c1770b0be595d0fbddabd1aa919b799e46
|
|
BLAKE2b-256 checksum How to use checksums |
09ccd7f8ad2c9249be0674d9f05ff61a9b4e0f11ddec83cc8eb645e7bad03db8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
