Practical overview
When it fits
Use CubeLoop when building a Python agent application and a linear async control flow, provider interface, tool handling or optional persistence fits the design.
Who it is for
- Python developers building AI agent applications.
- Teams that want a readable async runtime with optional database checkpointing.
- Developers integrating Anthropic or OpenAI models and Python-defined tools.
Documented uses
- Assemble an agent from a model provider, system prompt and Python tools.
- Handle agent output as streamed events.
- Add a documented SQLite, PostgreSQL or MySQL checkpointer extra.
- Add optional MCP tool loading or OpenTelemetry tracing and metrics.
Requirements & limits
The repository is public and identifies the project as MIT-licensed. The package installation instructions use pip or uv.
- The framework uses a linear async loop instead of graph nodes and edges.
- The README lists Anthropic and OpenAI as built-in providers and describes a Provider protocol for adding others.
- SQLite, PostgreSQL, MySQL, MCP loading and tracing are installed as optional extras.
- The README describes append-only checkpointing and async event streaming as core design distinctions.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up a basic CubeLoop agent
Install CubeLoop and assemble the README’s provider-backed agent example.
Before you start
- Python environment with pip
- CubeLoop installed with
pip install cubeloop - Anthropic API key for the README’s example provider
Steps
Install the
cubelooppackage with pip.Create an
AnthropicProviderusing a provider ID and API key.Declare an async function with the
@tooldecorator and supply it to anAgentwith a model and system prompt.Subscribe to agent events and call
agent.promptwithin an asyncio event loop.
Expected outcome
A configured agent that can receive a prompt and emit streamed text events through the subscriber.
Guide limitations
- The example uses Anthropic; provider credentials are required for real model interaction.
Add a database checkpointer
Install a documented optional database extra for CubeLoop persistence.
Before you start
- Python environment with pip
- CubeLoop package
Steps
Choose the documented SQLite, PostgreSQL or MySQL checkpointer extra.
Install it using the matching package extra:
cubeloop[sqlite],cubeloop[postgres]orcubeloop[mysql].
Expected outcome
The selected database checkpointer extra is included in the CubeLoop installation.
Guide limitations
- The cited install instructions do not explain database configuration or how to use the checkpointer in an application.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 7 October 2026
- Original website title
- cubeplexai/cubeloop · Official homepage title · retained in its source language

