Swirls Cloud

Swirls Cloud is the recommended way to run workflows in production. It handles the infrastructure so you can focus on building workflows.

What Swirls Cloud provides

• Execution infrastructure — Runs your graphs with automatic retries, error handling, and logging.
• Scaling — Handles concurrent executions without infrastructure management on your part.
• Stream storage — Persistent, queryable storage for graph outputs.
• Secret management — Encrypted storage for API keys and credentials, available to nodes at execution time.
• Form hosting — Hosted form endpoints with schema validation.
• Webhook endpoints — Managed HTTP endpoints for inbound webhooks.
• Cron scheduling — Reliable cron execution with timezone support.
• Portal — Web UI for managing projects, viewing executions, reviewing nodes, and debugging runs.
• Monitoring — Execution logs, error tracking, and run history.

Getting started

1. Sign up at the Portal.
2. Create a project and note the project ID.
3. Install the CLI and authenticate: swirls auth login.
4. Initialize your config: swirls configure.
5. Sync your .swirls files: swirls sync.

Your .swirls files are the source of truth. Deploying means syncing them to your project.

CI/CD integration

Add swirls sync to your deployment pipeline to keep your project in sync with your repository:

swirls sync

The CLI reads swirls.config.ts for your project ID. Store your Swirls credentials as environment variables in your CI provider and authenticate non-interactively before running sync.

Next steps

• Local Development — Set up the CLI and iterate on workflows locally.
• CLI reference — Full reference for all CLI commands.
• Self-hosting — Run the platform on your own infrastructure.