3 stable releases
Uses new Rust 2024
| new 1.9.3 | May 8, 2026 |
|---|---|
| 1.9.1 | May 6, 2026 |
#4 in #wfe
Used in 2 crates
10KB
Generated gRPC stubs for the WFE workflow server API.
Built from proto/wfe/v1/wfe.proto. Includes both server and client code.
use wfe_server_protos::wfe::v1::wfe_server::WfeServer;
use wfe_server_protos::wfe::v1::wfe_client::WfeClient;
Sunbeam Studios Monorepo
A self-hosted cooperative studio shipping its own platform, agents, apps, game engine, and AI tooling from a single Rust-flavored monorepo.
What lives here
| Directory | Contents |
|---|---|
platform/ |
Core infrastructure: WFE workflow engine, CLI, HTTP proxy, Sol AI agent |
apps/ |
User-facing products: driver, kanban, sunbeam-meet, kratos-admin, site, typst-editor, estafeta |
libs/ |
Shared libraries: beam-ui (React), beam-ui-typst, storybook, mistralai-client-rs, sunbeam-dg (discrete global grid), mcp-server |
engines/ |
Game engines: marathon (Bevy + iroh) |
infra/ |
Deployment: sbbb kustomize manifests and infrastructure configuration |
owned-forks/ |
Permanent forks: tuwunel (Matrix homeserver), forgejo, penpot, penpot-mcp |
3p/ |
Upstream Rust libraries as submodules: tokio, mio, pingora |
forks/ |
Service forks as submodules: kratos, keto, hydra, headscale, tailscale, element-call, element-desktop, bulwark, polis |
research/ |
Exploration: dirt, demikernel |
Getting started
git clone --recursive https://src.sunbeam.pt/studio/sunbeam
cd sunbeam
direnv allow
cargo check --workspace --exclude tuwunel
Platform support
Development targets macOS and Linux only. Windows is an end-user deployment target (SBBB desktop shell, Tauri applications) but not a contributor environment.
Git hosting
The entire development lifecycle — issues, pull requests, CI, releases — runs on the Sunbeam Gitea at src.sunbeam.pt. Any presence elsewhere (GitHub, Codeberg, etc.) is a one-way mirror from there, not a fork to contribute against.
Workspace management
The sunbeam CLI (from platform/cli) provides workspace and worktree management. See docs/CONTRIBUTING.md for contributor workflows.
Licensing
Each project in this monorepo carries its own license. There is no single workspace-wide license. See the LICENSE (or LICENSE.md) file at the root of each project directory (e.g., platform/cli/LICENSE.md, apps/sunbeam-meet/LICENSE, owned-forks/tuwunel/LICENSE). Submodules under 3p/ and forks/ carry the upstream project's license verbatim.
Next steps
- Layout details: docs/LAYOUT.md
- Monorepo configs: docs/CONFIGS.md
- Worktree system: docs/WORKTREES.md
- Project / workspace spec: docs/SPEC.md
- Contributing: docs/CONTRIBUTING.md
- Retired repository history: docs/retired-repos.md
- Architecture: (Coming soon)
Dependencies
~8–13MB
~160K SLoC