Skip to content

Open Source

Spooled Cloud is open source software. View the code, report issues, contribute features, and self-host on your own infrastructure.

View on GitHub

https://github.com/Spooled-Cloud

License

Spooled Cloud is licensed under the Apache License 2.0:

  • ✅ Use commercially
  • ✅ Modify and create derivative works
  • ✅ Distribute copies
  • ✅ Sublicense
  • ✅ Use for private use
Copyright 2025 Spooled Cloud

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Repository Structure

Repository Description Language
spooled-backendCore API server and queue engineRust
spooled-dashboardReal-time web dashboardReact
spooled-frontendMarketing site and docs (closed-source)Astro
spooled-sdk-nodejsNode.js SDKTypeScript
spooled-sdk-pythonPython SDKPython
spooled-sdk-goGo SDKGo

Contributing

Development Setup

# Clone the repository
git clone https://github.com/spooled-cloud/spooled-backend.git
cd spooled-backend

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Start dependencies
docker compose up -d postgres redis

# Run the server
cargo run

# Run tests
cargo test

Contribution Guidelines

  • Code style — Follow existing patterns. Run formatters before committing.
  • Tests — Add tests for new features and bug fixes.
  • Documentation — Update docs for API changes.
  • Commit messages — Use conventional commits (feat:, fix:, docs:).

Pull Request Process

  1. Fork the repository
  2. Create a feature branch
  3. Make changes with clear commits
  4. Ensure tests pass
  5. Open a pull request

Development Workflow

We use trunk-based development with feature branches merged back to main: 

%%{init: {'theme': 'base', 'themeVariables': { 'git0': '#10b981', 'git1': '#3b82f6', 'git2': '#f59e0b', 'gitBranchLabel0': '#065f46', 'commitLabelColor': '#6b7280' }}}%%
gitGraph
  commit id: "v1.0.0"
  branch feature/workflows
  checkout feature/workflows
  commit id: "add dag parser"
  commit id: "workflow engine"
  checkout main
  merge feature/workflows
  commit id: "v1.1.0"
  branch feature/priority-queues
  checkout feature/priority-queues
  commit id: "priority impl"
  checkout main
  merge feature/priority-queues
  commit id: "v1.2.0"

Security

If you discover a security vulnerability, please email security@spooled.cloud rather than opening a public issue.

Roadmap

Key upcoming features:

  • 🔜 Workflow orchestration (multi-step jobs)
  • 🔜 Priority queues
  • 🔜 Job batching and aggregation
  • 🔜 Terraform provider
  • 🔜 Managed workers

Get Involved