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 cloud auth login.
4. Initialize your config: swirls configure.
5. Deploy your .swirls files: swirls cloud deploy.

Your .swirls files are the source of truth. Deploying compiles them and uploads the resulting workflow definitions to your project.

CI/CD integration

Add swirls cloud deploy to your deploy step:

swirls cloud deploy

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 deploy.

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.