---
title: README
emoji: "🛰️"
colorFrom: blue
colorTo: green
sdk: static
pinned: false
---

![Ratio1 banner](./assets/banner.svg)

# Ratio1

**Decentralized AI infrastructure for builders and partner teams.**

Ratio1 helps teams build, deploy, and operate intelligent products without giving up control of their models, data paths, runtime, or economics.

[Website](https://ratio1.ai) • [GitHub](https://github.com/Ratio1) • [Documentation](https://github.com/Ratio1/docs)

[What we do](#what-we-do) • [How we do it](#how-we-do-it) • [Build with Ratio1](#build-with-ratio1) • [Why teams use Ratio1](#why-teams-use-ratio1)

## Positioning

Ratio1 is built for teams that want AI infrastructure they can operate, extend, and trust. We focus on practical delivery: developer tooling, distributed execution, controllable data paths, and network economics that fit production workloads instead of locking them into a single hosted stack.

## What We Do

- Help builders ship low-code and code-first AI products faster.
- Run intelligent workloads across decentralized and edge-connected compute.
- Support partner deployments that need clearer operational ownership and private data movement.
- Publish reusable models, datasets, demos, and docs for the Ratio1 ecosystem.

## How We Do It

- Edge-native execution surfaces for distributed AI workloads.
- SDKs and runtime libraries that expose real integration primitives.
- Operator-controlled deployment patterns for privacy-sensitive environments.
- Incentivized participation and observable infrastructure rather than black-box hosting.

## Build With Ratio1

The core builder surface is open and actively evolving.

| Repository | Purpose |
| --- | --- |
| [`ratio1_sdk`](https://github.com/Ratio1/ratio1_sdk) | Python SDK for integrating with the Ratio1 ecosystem. |
| [`edge_node`](https://github.com/Ratio1/edge_node) | Edge execution layer for decentralized AI nodes and workloads. |
| [`naeural_core`](https://github.com/Ratio1/naeural_core) | Core runtime components used across the network stack. |
| [`deeploy-dapp`](https://github.com/Ratio1/deeploy-dapp) | App-facing deployment surface for interacting with the ecosystem. |
| [`ratio1-docs`](https://github.com/Ratio1/docs) | Documentation source for builder onboarding, architecture, and partner material. |

## Why Teams Use Ratio1

- **Sovereignty:** keep control over where AI runs and how data moves.
- **Elastic capacity:** expand through decentralized infrastructure when centralized-only economics are a bad fit.
- **Partner readiness:** support enterprise and ecosystem deployments with clearer ownership boundaries.
- **Operational visibility:** work with observable primitives instead of opaque hosted abstractions.

## What You Will Find Here

This Hugging Face organization is the public front door for Ratio1 assets:

- model cards for reusable capabilities
- dataset cards for publishable data surfaces
- demos and static Spaces for product and partner narratives
- documentation links back to the `ratio1-docs` source