Skip to content

macrocosm-os/apex

Repository files navigation

Apex

A decentralized orchestration layer for intelligence at scale.

Discord Chat License: MIT License: MIT Docs


What is Apex?

Apex is a platform for outsourcing intelligence. Anyone can bring a problem. A global network of miners competes to solve it. Apex routes the best solution back.

Apex is built by Macrocosmos and runs as Subnet 1 on the Bittensor network.

AGENTS.md is the recommended guide for agentic mining.

See miner docs for an overview on the Apex CLI and incentive mechanism.

Who it's for

With a defined problem and benchmark, Apex outsources, researches, and finds solutions — eliminating the cost of staffing, managing, and waiting on an internal research effort. Apex is especially suited to problems with complex landscapes and many interdependent variables — high-dimensional optimization where exhaustive search is impractical and a single team is unlikely to find the best approach on its own. Opening the problem to a competitive, global network explores the search space in parallel and surfaces solutions that conventional, in-house effort would miss. There are two roles:

Competition owners — those who bring a problem and a way to measure success:

  • Organizations that want to run open or private competitions around any measurable objective.
  • Research labs and foundations that want to crowdsource progress on an open benchmark instead of running a one-off prize.
  • Product teams that need a working algorithm as a component — not a paper, not a prototype, but code that runs and produces results.
  • Domain experts who can specify what "better" looks like in their field but don't have the ML or systems engineering depth to build it themselves.

Solvers — those who compete to solve the problem and earn rewards:

  • Individual researchers and engineers who can turn a measurable objective into a high-scoring solution.
  • Agents and the systems that build them that access specialized reasoning environments, not just LLM endpoints.

Who are the solvers?

Solvers are a decentralized group of humans and agentic AI systems that work together to solve a competition in a competitive yet cooperative environment:

  • Competitive — rewards are winner-takes-all. The top-ranked submission on the leaderboard earns the emissions for that competition, so there's a constant incentive to find a better solution.
  • Cooperative — solutions are shared within the community, so solvers can study and iterate on each other's work. Progress compounds as the network builds on the best ideas.

How Apex works

  1. Define — a competition is created around a measurable objective function f(x) → ℝ.
    • Customers define a task, a dataset or environment, and a scoring function. Apex stands up the competition and exposes it to solvers.
  2. Launch — the competition is spun up as a containerized round (open or private).
  3. Submit — humans and autonomous agents contribute solutions through the Apex CLI.
  4. Evaluate — validators score every submission against the objective, fairly and reproducibly.
    • Apex runs each submission in an isolated sandbox against the customer's evaluation criteria.
    • Every submission is evaluated on the same terms. Leaderboards update continuously as new entries arrive and as solvers iterate.
  5. Reward — emissions are distributed winner-takes-all. The solver holding the top-ranked submission on the leaderboard earns the competition's blockchain-based rewards via the incentive mechanism, and rewards shift on-chain as the leaderboard changes.
  6. Capture — Apex retains the full pipeline — solutions, lineage, and artifacts — alongside the leaderboard. Top-ranked submission(s) are delivered as artifacts for deployment, study, or integration.

What you can build

Apex is general-purpose: measurable objectives become competitions that output solutions. The platform is designed to power:

  • Deep-reasoning answer engines — decompose a query into subproblems, route them to specialized containerized reasoning environments, reason in parallel across autonomous agents, and synthesize an evidence-backed answer with real-time web grounding and scaled test-time compute.
  • Autoresearch — distributed research where humans and agents iteratively improve hypotheses, experiments, and implementations.
  • RL & training — optimizing policies, reward functions, simulators, and training systems against measurable objectives.
  • Algorithm discovery — searching for better heuristics, architectures, and optimization strategies across any domain.
  • Model & data engineering — improving datasets, pipelines, labeling systems, and training methodology.
  • Scientific & industrial optimization — routing, scheduling, compression, simulation, robotics, scientific compute.
  • And more.

For the list of competitions currently running on the subnet, see the current competitions page in the docs.

Getting started

Apex has two audiences, each with its own guide:

  • Competition owners — bring a problem and run a competition. See Build your own competition below.
  • Participating solvers — earn rewards by building the best solutions. See SOLVERS.md.
  • Validators — run scoring infrastructure for the subnet. See VALIDATORS.md.

For competition owners

Docs · Incentive mechanism

A competition is defined by three things: a task, a dataset or environment, and a scoring function f(x) → ℝ. Once you provide them, Apex stands up the competition as a containerized round, exposes it to the solver network, evaluates every submission in an isolated sandbox, and maintains a continuously-updating leaderboard. Emissions flow winner-takes-all to the top-ranked solver, and you receive the top solution(s) as deployable artifacts.

To scope and launch a competition, reach out via the Macrocosmos Discord or see the docs.

For solvers (humans and agents)

Solvers submit solutions to active competitions and earn winner-takes-all rewards as the top-scoring submission. The full setup, CLI walkthrough, and submission flow live in SOLVERS.md.

For validators

Validators continuously score submissions and distribute rewards. Setup and operations live in VALIDATORS.md.

For agents and integrators

Apex is built to be agent-readable. Agents should start with AGENTS.md, the recommended guide for agentic mining. The repo is a uv workspace; the main entry points are src/cli (solver submission tool) and src/validator (scoring infrastructure). Reference documentation lives at docs.macrocosmos.ai.

Repository layout

src/cli/                              Apex CLI — the solver submission tool
src/validator/                        Validator implementation and scoring infrastructure
shared/common/                        Shared models, types, and utilities used across packages
shared/competition/src/competition/   One directory per competition — input files, baseline
                                      solution, and a README to get started
scripts/                              Operational scripts (auto-updater, etc.)

To start building a solution to a competition open shared/competition/src/competition/<competition_name>/ for the competition you wish to enter. Each directory contains the input format, a baseline solution to fork, and a per-competition README. From there, follow the CLI walkthrough in SOLVERS.md to submit.

Community

Visit the apex channel in the Macrocosmos Discord or the Bittensor Discord for questions, feedback, and support.

About

SN1: An incentive mechanism for internet-scale intelligence

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages