Official Animica Pool

Mine Animica on the
official pool.

Point your Animica miner at the public Stratum endpoint. CPU mining is supported; setup installs the local model bundle for optional AICF compute earnings.

Stratum

pool.animica.org:3333

Website

https://pool.animica.org
Quick Start Explorer Main site

Pool Status

checking…
Stratum host
…
Stratum port
…
Connected miners
…
Network
…
Next payout in
—
interval: —

Quick Start

Connect in three commands

These commands use the Python package published as animica. Run them on Linux or macOS with Python 3.10+ installed. Windows users should run them under WSL2.

Linux / macOS terminal 
python3 -m pip install --upgrade animica
animica miner setup
animica miner mine-blocks --count 0 --pool-stratum stratum+tcp://pool.animica.org:3333
1. Install Animica

Installs the CLI, CPU miner, pool client, wallet helpers, and AICF worker.

2. Run setup

Detects hardware, prepares ~/.animica/models/, and is safe to rerun.

3. Start mining

Connects to pool.animica.org:3333. Press Ctrl-C to stop.

Detailed setup

Step-by-step walkthrough

Use this if you want to understand what each command does, configure a dedicated payout wallet, or tune the miner for your hardware.

Recommended

Python 3.10+, 4 GB RAM, 10 GB free disk (more for AICF model bundles)

Outbound network

TCP 3333 to pool.animica.org and HTTPS for installs/downloads

  1. 01

    Install Animica

    The animica Python package ships the CLI, the CPU/GPU miner, the Stratum pool client, wallet helpers, and the AICF compute worker. 

    python3 -m pip install --upgrade animica
animica --version

    On managed Python installs (Debian/Ubuntu) you may need --break-system-packages or a virtualenv: python3 -m venv ~/animica-venv && source ~/animica-venv/bin/activate.

  2. 02

    Create a payout wallet

    The pool needs a Bech32 address (anim1...) to credit your shares. Create a fresh wallet labeled miner and make it the default: 

    animica wallet new --label miner
animica wallet set-default miner
animica wallet list

    Already have a wallet? Skip the first two commands and pass --address anim1... (or a label) directly to mine-blocks. Wallet files live under ~/.animica/wallets.json — back this up before mining.

  3. 03

    Run hardware setup

    Detects CPU, RAM, and GPUs, picks eligible model tiers, prepares ~/.animica/models/, and downloads any AICF model bundles your machine qualifies for. It is idempotent and safe to rerun. 

    animica miner setup

    Useful flags: --tiers tiny,small install only specific tiers, --skip-download detect hardware but skip model pulls, --source huggingface always pull from HF rather than IPFS, --json emit a machine-readable report.

  4. 04

    Start mining against the pool

    --count 0 mines until you press Ctrl-C. --pool-stratum connects to the official Stratum endpoint; omit it to mine solo against a local Animica node. AICF compute runs alongside PoW by default and earns bonus credits on capable hardware. 

    animica miner mine-blocks \
  --count 0 \
  --pool-stratum stratum+tcp://pool.animica.org:3333

    To run as a background daemon, wrap it in nohup, tmux, or a systemd unit. Set ANIMICA_MINER_ADDRESS / ANIMICA_MINER_POOL to avoid repeating flags.

  5. 05

    Verify your worker

    Look for stratum subscribed in the miner output and confirm shares are being submitted. The pool API exposes live worker state: 

    curl -s https://pool.animica.org/api/pool/summary | jq
curl -s https://pool.animica.org/api/pool/accounting | jq

    Block credits and payouts are visible on the explorer once a block you contributed to is confirmed.

Performance & advanced

Tune the miner for your hardware

All flags below are appended to animica miner mine-blocks. Defaults work out of the box; reach for these when you need to cap resource use or force a backend.

CPU threads
--threads 4

Caps PoW search threads. Default (0) saturates all cores minus one.

GPU backend
--device cuda
# or: --gpu
# also: rocm, opencl, metal, cpu, auto

Forces a specific accelerator. auto picks the best detected.

AICF compute
--no-aicf       # PoW only
--aicf-endpoint https://rpc.pool.animica.org/aicf

Disable the AI inference worker, or point it at a remote node when you do not run one locally.

Worker identity
--address anim1... | label
--pool-worker rig-01

Override the payout target and label this worker in the pool dashboard.

Wallet address guidance

The miner needs a payout wallet. The default command uses your configured default miner address. If you have not configured one yet, create or select a wallet first: 

animica wallet new --label miner
animica wallet set-default miner
animica miner mine-blocks --count 0 --pool-stratum stratum+tcp://pool.animica.org:3333

You can also pass a wallet label or address directly with --address anim1....

Troubleshooting

  • Connection refused: confirm your firewall allows outbound TCP to pool.animica.org:3333. Test with nc -vz pool.animica.org 3333.
  • No payout address: run animica wallet set-default <label> or pass --address.
  • Setup downloads fail: rerun animica miner setup after checking disk space and network access. Add --skip-download to bring up a PoW-only miner without AICF bundles.
  • Low performance: CPU mining works everywhere; use --threads N to cap CPU usage or --device cuda for NVIDIA GPUs.
  • AICF worker OOMs: rerun setup with --tiers tiny, or start the miner with --no-aicf to mine PoW only.
  • Stuck on "waiting for job": the pool may be between templates; if it persists more than a minute, check https://pool.animica.org/api/pool/summary.

Pool details

Name
Official Animica Pool
Stratum
pool.animica.org:3333
Website
https://pool.animica.org