Skip to content

Repository files navigation

logo lightlogo dark

DocsLast commitPyPI - VersionCoverageKubernetesDiscordStarsIntegration Tests (main)


Exosphere: Reliability Runtime for AI Agents

Exosphere is a lightweight runtime to make AI agents resilient to failure and infinite scaling across distributed compute. With a few changes to your existing agent code, take your agent from demo to deployment.

Why Exosphere?

Exosphere provides a powerful foundation for building and orchestrating AI applications with these key capabilities:

FeatureDescription
Lightweight RuntimeExecute workflows reliably with minimal overhead across distributed infrastructure using a state-based execution model.
Inbuilt Failure HandlingBuilt-in retry policies with exponential backoff and jitter strategies for resilient, production-grade execution.
Infinite Parallel AgentsScale to unlimited parallel agents with automatic load distribution and dynamic fanout at runtime.
Dynamic Execution GraphsDurable execution designed for agentic flows with node-based control of execution.
Native State PersistencePersist workflow state across restarts and failures with graph-level key-value storage.
ObservabilityVisual monitoring, debugging, and management of workflows with real-time execution tracking.

Whether you're building data pipelines, AI agents, or complex workflow orchestrations, Exosphere provides the infrastructure backbone to make your AI applications production-ready and scalable.


Run Your First Agent

StepDescription
Getting StartedGet the Exosphere State Manager and Dashboard running locally for development.
Run Your First NodeCreate your first node and register it with the Exosphere runtime.
Trigger AgentLearn how to trigger your agent workflows and manage execution flows.
Deploy and MonitorDeploy your agents and monitor their execution with the visual dashboard.

How does this work?


Architecture Overview

Exosphere is built on a flexible, node-based architecture that makes it easy to create complex workflows:

Exosphere Architecture

Core Components

ComponentDescription
NodesAtomic, reusable units of work that can be AI agents, API calls, data processors, or any custom logic
RuntimeThe execution environment that manages and orchestrates your nodes
State ManagerHandles persistent state across workflow executions
DashboardVisual interface for monitoring and managing workflows
GraphsDefine the flow and dependencies between nodes

Key Concepts

Building blocks of Exosphere

ConceptDescription
FanoutDistribute work across multiple parallel instances of a node
UniteCombine results from multiple parallel executions
SignalsInter-node communication and event handling
Retry PolicyConfigurable failure handling and recovery
StorePersistent storage for workflow state and data
TriggersAutomatic scheduling with cron expressions

Resources

ResourceNotes
Getting Started GuideComplete walkthrough for new users
Docker Compose SetupRun Exosphere locally in minutes
Architecture GuideUnderstand core concepts like fanout and unite
YouTube WalkthroughsStep-by-step demos on Exosphere with sample code
Featured ProjectsTemplates on common projects, pull and run

Community and Support

ResourceDescription
Official DocumentationComplete reference and tutorials
Discord CommunityGet help and connect with other developers
GitHub IssuesReport bugs and request features
PyPI PackageLatest stable releases

Open Source Commitment

We believe that humanity would not have been able to achieve the level of innovation and progress we have today without the support of open source and community. We want to be a part of this movement.

Please feel free to reach out to us at nivedit@exosphere.host. Let's push the boundaries of possibilities for humanity together.


Release Cycle and Roadmap

Exosphere follows a predictable, calendar-based release process:

AspectDescription
Monthly ReleasesA new stable version ships at the end of every month
Issue and PR LabellingWork intended for a release is tagged YYYY:Mon (e.g., 2026:Jan). Filter by this label in GitHub to see exactly what is planned
Living RoadmapThe collection of items carrying the current month's label is our public roadmap. Follow along in GitHub Projects to track progress in real time

Contributing

We welcome community contributions. For guidelines, refer to our CONTRIBUTING.md.

Thanks to our awesome contributors!

exosphere.host Contributors

About

Runtime for building and managing AI agents and Workflows. Easy to learn, fast to build, High Performance, Reliable by design, Intuitive UI, Production Ready.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

203 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages