Start Here
Sero is a desktop app for working on local software projects with an AI coding agent. It brings project workspaces, chat, terminals, previews, files, source control, and plugins into one local shell.
Sero is available as a public beta desktop release. Most users should download the packaged installer for their platform from GitHub Releases; developers and contributors can still build from source. This is still beta software: support is best effort, updates are manual unless release notes say otherwise, and plugin/runtime APIs may change.
What Sero helps you do
Sero is designed for agent-assisted development work where the agent needs more than a chat box.
Use Sero when you want to:
- open a project workspace and keep the agent near the files, terminals, and previews it needs
- ask an AI coding agent to work with local project context
- inspect app previews and browser-like workflows in the same desktop shell
- add workflow-specific tools through plugins
- keep project state local unless you choose to connect external services
Sero is built on Pi, an open-source coding agent platform. You do not need to understand Pi internals to start using Sero.
Who the beta is for
The public beta is a good fit if you are:
- using a supported packaged desktop target listed in Support Scope
- an early adopter who is comfortable with beta-quality workflows
- a developer or contributor who wants to build from source
- okay with changing plugin/runtime contracts
It is probably not the right fit yet if you need:
- stable commercial polish
- production-stable workflows
- a hosted cloud IDE
- fully stable plugin APIs
- identical capabilities on every operating system
What to do first
- Check Support Scope for the current platform and workspace runtime support contract.
- Follow Get Sero Running to install the packaged beta, or use the source-build path if you are developing Sero.
- When you open or configure a workspace, use the default runtime if you are unsure. Read Choose a Workspace Runtime if you need container behavior or want to switch later.
- Set up your profile and providers with Profiles and Onboarding and Models and Providers.
Learn the workspace after first launch
After Sero opens, these pages explain the main surfaces:
- Workspace and Chat — the shell, sidebar, workspaces, sessions, and global chat panel.
- Explorer Workspace — files, editor previews, browser tabs, terminals, and source control.
- Agent Sessions and Context — composer controls, context, voice, steering, and queues.
- Plugins and Apps — bundled apps, installed plugins, widgets, and plugin concepts.
- Plugin Catalog — built-in and external/local plugins at a glance.
Look up exact facts
Use reference pages when you need a precise answer:
- Support Scope — canonical platform, runtime, and issue-reporting support facts.
- Troubleshooting — what to try when setup or a workspace fails.
- Environment Doctor — diagnostics, safe mode, output states, and redaction behavior.
- Security / Privacy — local state, credentials, logs, and remote-access cautions.
Before filing issues, redact tokens, auth files, private paths, and sensitive project details from logs, screenshots, and reproduction notes.