Thank you for your interest in contributing to tinyMem! As an evidence-based memory system, we have strict guidelines to ensure truth discipline and reliability.
- Truth Discipline: Never auto-promote model output to truth. Facts require local evidence verification.
- Streaming First: All LLM interactions must remain streaming-first to ensure low latency for the user.
- Local Execution: No cloud dependencies. All state must remain project-scoped in
.tinyMem/. - Zero Config: Sensible defaults must work out of the box.
- Fork and Clone: Create your feature branch from
main. - Go Modules: We use Go 1.22+. Ensure your
go.modandgo.sumare updated. - Tests: Run standard tests with
go test ./.... Run the full Python test suite intest/before submitting a PR. - Doctor: If you add new functionality that can fail, update
internal/doctorto include a diagnostic check.
- Ensure all tests pass.
- Update
README.mdor relevant documentation indocs/if you change behavior. - Keep PRs focused and atomic.
By contributing to tinyMem, you agree that your contributions will be licensed under the project's MIT License.