# Allora Network Documentation

> Allora is a self-improving decentralized AI network: an open-source marketplace for machine intelligence where workers supply ML inferences, reputers score them against ground truth, and validators secure the chain.
> These docs cover network concepts (topics, rewards, tokenomics) and hands-on guides for building on Allora as a worker, reputer, validator, topic creator, or consumer of inferences.

All pages live under https://docs.allora.network/. The site root redirects to /home/explore.

## Home

- [Explore Allora](https://docs.allora.network/home/explore): Entry point introducing Allora as an open-source, decentralized marketplace for intelligence, with links into the rest of the docs.
- [Overview](https://docs.allora.network/home/overview): How Allora combines blockchain and AI/ML to overcome information inefficiency, and an introduction to the network's design.
- [Key Terminology](https://docs.allora.network/home/key-terms): Definitions of core terms such as topics, rule sets, inferences, and context awareness.
- [Participants](https://docs.allora.network/home/participants): The roles in the network — workers, reputers, validators, and consumers — and how each participates.
- [Layers of the Network](https://docs.allora.network/home/layers): The three layers of the Allora network: inference consumption, forecast and synthesis, and consensus.
- [Inference Consumption](https://docs.allora.network/home/layers/inference-consumption): The request/response flow between consumers and workers, and how topics coordinate the network.
- [Forecast and Synthesis](https://docs.allora.network/home/layers/forecast-synthesis): How inferences are scored by forecast workers and combined into a single synthesized network inference.
- [Forecast](https://docs.allora.network/home/layers/forecast-synthesis/forecast): How forecasting workers predict the performance of other workers' inferences, making the network context-aware.
- [Synthesis](https://docs.allora.network/home/layers/forecast-synthesis/synthesis): How individual inferences are weighted and combined into an aggregate network inference each epoch.
- [Consensus](https://docs.allora.network/home/layers/consensus): The CometBFT proof-of-stake consensus layer and the differentiated incentives for each network participant.
- [Worker Rewards](https://docs.allora.network/home/layers/consensus/workers): How workers are scored via one-out and one-in inferences and rewarded for their contribution to the network inference.
- [Reputer Rewards](https://docs.allora.network/home/layers/consensus/reputers): How reputers are rewarded based on accuracy relative to consensus and stake, with measures against reward centralization.
- [Topic Rewards](https://docs.allora.network/home/layers/consensus/topic-rewards): How topic rewards are distributed across inference workers, forecast workers, and reputers.
- [Total Rewards](https://docs.allora.network/home/layers/consensus/total-rewards): How total network rewards are split between economic security (validators, reputers) and intelligence contributors.
- [Tokenomics](https://docs.allora.network/home/tokenomics): The ALLO token and the Pay-What-You-Want fee model for inferences generated by the network.
- [Delegating Stake](https://docs.allora.network/home/delegating-stake): How to earn passive rewards by delegating stake to a reputer, and the safeguards involved.
- [Confidence Intervals](https://docs.allora.network/home/confidence-intervals): How the network produces weighted, percentile-based confidence intervals around its predictions.
- [Release Notes](https://docs.allora.network/home/release-notes): Version-by-version release notes for the Allora Network.
- [Whitepaper](https://docs.allora.network/home/whitepaper): Glossary of key terms used in the Allora whitepaper (full PDF: https://research.assets.allora.network/allora.0x10001.pdf).

## Developers: Get Started

- [Overview](https://docs.allora.network/devs/get-started/overview): Orientation to the main Allora repositories and how to start contributing to the ecosystem.
- [Setup Wallet](https://docs.allora.network/devs/get-started/setup-wallet): Create an Allora wallet with the allorad CLI.
- [Installation](https://docs.allora.network/devs/get-started/cli): Install the allorad CLI and connect to an Allora network.
- [Basic Usage](https://docs.allora.network/devs/get-started/basic-usage): Straightforward ways to interact with the network, including querying inferences on-chain.
- [Managing Gas](https://docs.allora.network/devs/get-started/managing-gas): How gas and EIP-1559-style fees work on Allora and how to structure transactions accordingly.
- [Existing Topics](https://docs.allora.network/build/forge/topics): Live topic tables for Allora testnet and mainnet — topic IDs, metadata, epoch lengths, and categories — plus how to verify a topic's status.
- [How to Query Network Data using allorad](https://docs.allora.network/devs/get-started/query-network-data): allorad query commands for network-level data on the Allora chain.
- [Allora Forge Competitions](https://docs.allora.network/build/forge/competitions): How Allora Forge competitions work — compete on live topics, build a testnet track record, and graduate to mainnet where top performers earn ALLO rewards.

## Developers: Topic Creators

- [Topic Life Cycle](https://docs.allora.network/devs/topic-creators/topic-life-cycle): The stages a topic goes through from creation to conclusion, and key terms such as epoch length.
- [How to Create/Fund a Topic using allorad](https://docs.allora.network/devs/topic-creators/how-to-create-topic): What topics are and how to create and fund one with allorad.
- [How to Query Topic Data using allorad](https://docs.allora.network/devs/topic-creators/query-topic-data): allorad query commands for data about specific topics.

## Developers: Consumers

- [Consumers](https://docs.allora.network/devs/consumers): What consumers and consumer contracts are and how they use inferences generated by the network.
- [Allora API Endpoint](https://docs.allora.network/devs/consumers/allora-api-endpoint): Query real-time data of the latest topic inferences through the Allora API, including authentication with an API key.
- [RPC Data Access](https://docs.allora.network/devs/consumers/rpc-data-access): Access Allora network data directly through RPC endpoints as an alternative to the Allora API.

## Developers: SDKs

- [Overview](https://docs.allora.network/devs/sdk/overview): Overview of the official Allora SDKs for TypeScript and Python.
- [TypeScript SDK](https://docs.allora.network/devs/sdk/allora-sdk-ts): Install and use the Allora TypeScript SDK to interact with the Allora API from JavaScript and TypeScript applications.
- [Python SDK](https://docs.allora.network/devs/sdk/allora-sdk-py): Install and use the Allora Python SDK to interact with the Allora API from Python applications.

## Developers: Workers

- [Workers](https://docs.allora.network/devs/workers): How data scientists contribute AI/ML models to the network as inference workers.
- [System Requirements](https://docs.allora.network/devs/workers/requirements): Hardware and software requirements for running a worker node.
- [Build and Deploy a Worker Node using Docker](https://docs.allora.network/devs/workers/deploy-worker/using-docker): Run a worker node supported by an inference server using Docker (deprecated in favor of the Python SDK).
- [Migrate from the Offchain Node](https://docs.allora.network/devs/workers/migrate-from-offchain-node): Move a worker off the deprecated allora-offchain-node + Model Development Kit stack onto the Allora Python SDK and the Forge Builder Kit.
- [Walkthrough: Build a Price Prediction Worker](https://docs.allora.network/devs/workers/walkthroughs/walkthrough-price-prediction-worker): Train a small BTC/USD price model and submit its predictions to Allora's testnet sandbox topic with the Python SDK.
- [Build and Deploy a Forecaster](https://docs.allora.network/devs/workers/deploy-forecaster): What forecasters do on Allora, and how to submit forecasted losses to a topic with the published Python SDK's RPC client.
- [How To Query Worker Data using allorad](https://docs.allora.network/devs/workers/query-worker-data): allorad query commands for information about workers.
- [Query EMA Score of a Worker using allorad](https://docs.allora.network/devs/workers/query-ema-score): What worker EMA scores are and how to query them with allorad.

## Developers: Reputers

- [Reputers](https://docs.allora.network/devs/reputers): What reputers do — sourcing ground truth and evaluating the accuracy of worker inferences.
- [Deploy a Simple Reputer using Docker](https://docs.allora.network/devs/reputers/reputers): Configure and run a reputer node using Docker.
- [Build a Reputer](https://docs.allora.network/devs/reputers/build-a-reputer): Configure and run an Allora reputer node that serves ground truth and computes losses, stake ALLO on a topic, and verify your reputer's status.
- [Set and Adjust Stake](https://docs.allora.network/devs/reputers/set-and-adjust-stake): How stake works for reputers and how to set and adjust it.
- [How to Query Reputer Data using allorad](https://docs.allora.network/devs/reputers/query-reputer-data): allorad query commands for information about reputers.
- [Query EMA Score for a Reputer using allorad](https://docs.allora.network/devs/reputers/query-ema-score): What reputer EMA scores are and how to query them with allorad.

## Developers: Validators

- [Validators](https://docs.allora.network/devs/validators): How validators secure the Allora appchain through delegated proof of stake.
- [System Requirements](https://docs.allora.network/devs/validators/nop-requirements): Hardware requirements for mainnet and testnet validators.
- [Deploy Allora Chain](https://docs.allora.network/devs/validators/deploy-chain): The Allora appchain as the network's settlement layer and how to deploy it.
- [Run a Full Node](https://docs.allora.network/devs/validators/run-full-node): Run a full Allora node using systemd with cosmovisor or docker compose.
- [Stake a Validator](https://docs.allora.network/devs/validators/stake-a-validator): Steps to stake a validator: sync a full node, fund your account, and set up the validator.
- [Validator Operations](https://docs.allora.network/devs/validators/validator-operations): Operational tasks such as unjailing and unstaking/unbonding a validator.
- [Software Upgrades](https://docs.allora.network/devs/validators/software-upgrades): How to upgrade the Allora software versions during hard forks.

## Developers: Reference

- [Networks](https://docs.allora.network/devs/reference/networks): Chain IDs, endpoints, and the currently deployed allora-chain version for each Allora network.
- [allorad](https://docs.allora.network/devs/reference/allorad): Full reference of allorad query and transaction commands.
- [Module Accounts](https://docs.allora.network/devs/reference/module-accounts): The Cosmos SDK module accounts that hold funds and the flow of tokens through the network.
- [Stake Parameters](https://docs.allora.network/devs/reference/params/stake): Parameters governing validation staking and reputational staking.
- [Consensus Parameters](https://docs.allora.network/devs/reference/params/consensus): Consensus-level chain parameters that uniquely affect validators.
- [Mint Parameters](https://docs.allora.network/devs/reference/params/mint): Parameters of the minting module, including the mint denomination and inflation settings.
- [Chain Parameters](https://docs.allora.network/devs/reference/params/chain): Glossary and description of chain-level parameters and their default values.

## Community

- [How to Contribute](https://docs.allora.network/community/contribute): Developer and non-technical ways to contribute to the Allora ecosystem.
- [Resources](https://docs.allora.network/community/resources): Links to the whitepaper, documentation, and the Allora Points Program.

## Marketplace

- [Explore Allora's Marketplace](https://docs.allora.network/marketplace/explore): A set of plugins for developers to build and publish integrations using the Allora network.
- [Eliza OS: Example Usage with Eliza](https://docs.allora.network/marketplace/integrations/eliza-os/example-usage): Example of using the Allora Network plugin with an Eliza OS agent.
- [Eliza OS: Implementation](https://docs.allora.network/marketplace/integrations/eliza-os/implementation): How the Allora Network plugin for Eliza enables agents to access real-time inferences.
- [GOAT SDK](https://docs.allora.network/marketplace/integrations/goat-sdk): The Allora Network plugin for GOAT SDK, bringing AI-driven predictions to on-chain agents.