This repository contains examples and demos for Runloop, the platform for building AI-powered software engineering agents.
Please refer to the Runloop documentation site for more information on these demos.
Table of Contents
These examples show you how to use core Runloop features to build and run an agent.
| Example | Description | Python | TypeScript |
|---|---|---|---|
| Simple Coding Agent | Basic agent that can write and modify code | coding-agent/python/ |
coding-agent/typescript/ |
| Blueprints | Pre-built agent templates and patterns | blueprints/python/ |
blueprints/typescript/ |
| Code Mounts | Mount and work with external codebases | code-mounts/python/ |
code-mounts/typescript/ |
| Snapshots | Save and restore agent state | snapshots/python/ |
snapshots/typescript/ |
Self-contained examples for working with individual Devbox capabilities. Compose these to build custom agent workflows.
| Example | Description | Location |
|---|---|---|
| Start / Stop | Create, boot, and shut down a Devbox | devboxes/start-stop/ |
| Command Execution | Run shell commands inside a Devbox | devboxes/command-execution/ |
| Read / Write Files | Read and write files on a Devbox filesystem | devboxes/read-write-files/ |
| Web Tunnel | Expose a Devbox service via a public tunnel | devboxes/web-tunnel/ |
Runnable examples demonstrating Axons, Runloop's distributed event store, and Broker, the interchange layer between on-box agents and Axons.
| Example | Description | Python | TypeScript |
|---|---|---|---|
| ACP Protocol | Agent Client Protocol integration: installs Opencode, starts a session, and prompts the default bigpickle model |
axon-broker-agents/axon_acp_docs.py |
axon-broker-agents/axon_acp_docs.ts |
| Claude JSON Protocol | Claude JSON protocol integration with Runloop Axons | axon-broker-agents/axon_claude_docs.py |
axon-broker-agents/axon_claude_docs.ts |
These examples show you how to use add-ons which extend the core Runloop platform.
| Example | Description | Location |
|---|---|---|
| Computer Control | Interact with the local computer system | runloop-demo-computer/ |
| OpenClaw | Securely run OpenClaw inside Runloop Devboxes, including a parallel-execution example | openclaw/ |
Drive third-party cloud browser providers from Runloop devboxes. The agent runs in a devbox; the browser runs on the provider, so no Chromium runs in the devbox.
| Provider | Description | Python | TypeScript |
|---|---|---|---|
| Kernel | Kernel cloud browsers driven server-side via Playwright Execute | browser-integrations/kernel/python/ |
browser-integrations/kernel/typescript/ |
These examples show integrations with various LLM providers and frameworks.
| Provider/Framework | Description | Python | TypeScript |
|---|---|---|---|
| Anthropic | Claude API integration | llm-integrations/anthropic/python/ |
llm-integrations/anthropic/typescript/ |
| CrewAI | Multi-agent orchestration framework | llm-integrations/crewai/python/ |
- |
| Gemini | Google's Gemini API integration | llm-integrations/gemini/python/ |
llm-integrations/gemini/typescript/ |
| LangChain | LangChain framework integration | llm-integrations/langchain/python/ |
llm-integrations/langchain/typescript/ |
| LlamaIndex | LlamaIndex framework integration | llm-integrations/llamaindex/python/ |
llm-integrations/llamaindex/typescript/ |
| Mistral | Mistral AI API integration | llm-integrations/mistral/python/ |
llm-integrations/mistral/typescript/ |
| OpenAI | OpenAI API integration | llm-integrations/openai/python/ |
llm-integrations/openai/typescript/ |
| Vercel AI | Vercel AI SDK integration | - | llm-integrations/vercelai/typescript/ |
-
Runloop to Freestyle: compare SDK commands, files, pause/resume, firewall rules, and snapshot restoration.
-
Runloop to Modal: compare command execution and UTF-8 file round trips through both Python SDKs.
-
Reflex to OpenAI Agents API: managed sessions, personas, MCP connections, GitHub authentication, and continuing work.