Skip to main content

Contributing

Development setup and contribution guidelines.

Contributing

Thanks for helping improve Swarm 357. This repo is Python-first (packages/techtide-swarm) with an optional Rust Memvid bridge. The product landing page lives in a separate repository: TechTideOhio/swarm-357-site.

Setup

pip install -e "packages/techtide-swarm[dev]"
make test # or: cd packages/techtide-swarm && pytest -v -p no:schemathesis

Optional bridge:

cd packages/memvid-swarm-bridge && cargo build
export MEMVID_SWARM_BRIDGE="$(pwd)/target/debug/memvid-swarm-bridge"

Rules

  • Do not re-add scrubbed local trees (planning research dumps, vendored Memvid checkouts, or the old in-repo landing sample). Landing belongs in swarm-357-site.
  • Only workflow YAML (+ Dependabot) are allowed under .github/.
  • Keep claims in README/STATUS mechanically true; prefer CI gates over prose.
  • Conventional Commits for PR titles.

Docs