Contribute to stardelt
stardelt is open source under Apache 2.0, and help is welcome: code, docs, bug reports, or telling us what confused you. If you only want to use stardelt, start at the Quickstart.
Good ways to start
- Try the Quickstart and report what went wrong. A fresh pair of eyes finds things the maintainers cannot.
- Fix a page. Every page has an Edit this page link.
- Pick up an issue. Issues labelled
ready-to-implementlist the exact files, steps and checks. Comment "claiming" so nobody builds it twice.
The repositories
| Repository | What it is | Check before a pull request |
|---|---|---|
stardelt-docs | This site | npm run build |
stardelt-platform | Helm values, manifests, umbrella chart, install scripts | make lint, and make chart-template for chart changes |
stardelt-nova | The interface and API: Rust backend, React frontend | cargo check --all-targets, npm --prefix frontend run build |
stardelt-operator | The Kubernetes operator and its resources | cargo fmt --check, cargo clippy --all-targets -- -D warnings, cargo test |
stardelt-python | The Python package, command line and MCP server | python -m pytest tests -q |
stardelt-demos | Sample pipelines and the Airflow image | python -m pytest -q tests |
Work on the interface without a cluster
git clone https://github.com/stardelt/stardelt-nova
cd stardelt-nova
make demo # in-memory data; needs Rust and Node
Anything that touches a real service needs a real node: see Single Hetzner node.
Read next
- Contributing: branches, commits, review.
- How it is built: where things live and which rules hold everywhere.
- Recipes: the steps for common changes, so nothing gets forgotten.
- Writing a good issue: how to describe work so that anyone can do it.
- Skills for AI assistants: the same recipes, ready for an assistant to follow.