Skip to content

AffineFoundation/affine-cortex

Repository files navigation

Affine

Mine open reasoning.

Affine Discord | Live Dashboard

Introduction

Affine is an incentivized RL environment that pays miners who make incremental improvements on a set of tasks (such as program abduction or coding). The mechanism is sybil-proof, decoy-proof, copy-proof, and overfitting-proof.

How does Affine work?

Affine validators incentivize miners to submit models to Subnet 64 on Bittensor (a.k.a Chutes) where they are inference load balanced and publicly available. These models are evaluated on a set of RL environments, with validators looking for models that dominate the Pareto frontier—namely, models that outcompete all other models across all environments. The network uses a winners-take-all mechanism where miners are incentivized to copy, download, and improve the Pareto frontier model.

Why Affine?

Directed incentives for RL have never been achieved. The ability to direct intelligence and aggregate the work effort of a large, non-permissioned group of individuals on RL tasks will unlock rapid advancement in intelligence. We intend to commoditize reasoning (intelligence's highest form) and break the intelligence sound barrier.

Installation

# Install uv package manager
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install Affine
git clone https://github.com/AffineFoundation/affine.git
cd affine
uv venv && source .venv/bin/activate && uv pip install -e .

# Verify installation
af

Architecture

Affine uses Affinetes for container orchestration, providing:

  • Clean, lightweight container management
  • Support for local and remote Docker deployments
  • Environment caching for improved performance
  • Type-safe environment definitions

All evaluation environments are packaged as pre-built Docker images, eliminating the need for complex sandbox management.

Getting Started

For Miners

📖 Complete Miner Guide →

Learn how to:

  • Set up your environment and configure API keys
  • Pull models from the network
  • Improve models with reinforcement learning
  • Deploy to Chutes and commit on-chain
  • Use CLI commands to query your mining status

For Validators

📖 Complete Validator Guide →

Learn how to:

  • Set up and configure your validator
  • Run with Docker (recommended) or locally
  • Monitor validator performance
  • Troubleshoot common issues
  • Set weights on-chain

Additional Resources

  • 📚 FAQ - Frequently asked questions

SDK Usage

Affine can be used as an SDK for evaluating models across different environments.

Examples:

  • examples/sdk.py - Evaluate miners from the network on DED-V2 and ABD-V2 environments
  • examples/sdk2.py - Evaluate custom models by specifying model parameters directly

Key Features:

  • Evaluate registered miners by UID
  • Evaluate custom models with direct parameters (model, base_url, temperature)
  • Support for multiple environments (DED-V2, ABD-V2, etc.)
  • List all available environments
  • Async API for efficient batch evaluation

See the example files for complete usage patterns.

Support

About

Anima Machina

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 17

Languages