hello-world

Quickstart

Run your hello world agent in 2 minutes.
agent.push

Guides

Explore step-by-step guides to build your first AI agent.

​
Introduction

Cycls is an open-source distribution SDK for AI. It’s a zero-config platform designed to help you build, publish, and scale AI agents with unparalleled speed. With a single Python decorator and one command, you can transform your code into a user-ready product, complete with a front-end UI and an OpenAI-compatible API. Cycls goal is to let a single person innovate and ship a complete, user-facing AI agent without worrying about deployment and distribution.

​
Cycls Design Philosophy

We believe you should focus on creating innovative revenue-generating AI agents, not on configuring deployment pipelines. Cycls is built on a simple premise: Cycls handle distribution, so you can focus on innovation. Our zero-config approach makes your Python script the single source of truth for your agent. There are no YAML files, no Dockerfiles, and no complex configurations to manage. When your code is the only thing you need, you can:
  • Iterate Faster: The self-contained nature of a Cycls agent encourages a rapid, iterative workflow with your own models, frameworks, and libraries. This is called building in cycls.
  • Ship with Confidence: By removing complex abstractions, Cycls reduce the surface area for errors and simplify the path to production.
  • Accelerate with AI: The simplicity of our SDK makes Cycls code exceptionally friendly for LLMs to generate, helping you move from concept to code even faster.

​
How It Works

The developer experience is designed to be seamless, moving from local testing to global deployment without friction.
  1. Write: Implement your core logic in a standard Python function. This is where you bring your own models, frameworks, and libraries. Cycls is unopinionated, so you can use any tool you love.
  2. Decorate: Use the @agent() decorator to register your function. This is where you declaratively define dependencies, secrets, and authentication rules directly in Python.
  3. Run Locally: Run agent.run() in your terminal to spin up a local server with hot-reloading. You can immediately interact with your agent’s web UI at http://127.0.0.1:8000.
  4. Push to Cloud: Run agent.push() to deploy your agent to the Cycls cloud platform. Cycls automatically handle packaging, dependencies, and provisioning, making your agent live on a public URL in seconds.

​
Key Features

Cycls is designed to accelerate your workflow with powerful, developer-first features:
  • Work with Your Stack: Bring your own models, libraries, and frameworks. If it runs in Python, it runs on Cycls.
  • OpenAI-Compatible API: Automatically serve a streaming /chat/completions endpoint out of the box.
  • Customizable Web UI: Instantly get a clean, customizable front-end for your agent.

​
Cycls Cloud

Cycls offers a hosted version. Use agent.push() to deploy your agent to Cycls cloud.

​
Cycls Cloud Key Features

  • Quick Zero-Config Deployment: Run locally for instant testing, then deploy to a serverless cloud with a single command.
  • Built-in Authentication: Secure your agent with JWT authentication using a single auth=True flag.
  • Declarative Dependencies: Define pip, apt, and local file dependencies directly within your Python script.
  • Subscription Management: Manage user subscriptions and billing through the Cycls platform.

​
Start Building

Ready to build your first agent? Check out our Quickstart guide to create your first AI application in under 2 minutes. Or check out the guide to build your first LLM agent for a step-by-step walkthrough.