Contributing to Memori
Thank you for your interest in contributing to Memori. Whether you are fixing a bug, adding a feature, improving documentation, or just asking a question, every contribution helps make Memori better for everyone.
Want a zero-setup option? The Memori Cloud at app.memorilabs.ai.
The Memori source code lives on GitHub at github.com/MemoriLabs/Memori.
Ways to Contribute
There are many ways to contribute to Memori, and not all of them involve writing code:
Report Bugs
Found a bug? Open an issue on GitHub with:
- A clear title describing the problem
- Steps to reproduce the issue
- What you expected to happen versus what actually happened
- Your Python version, OS, and Memori version (
pip show memori)
Suggest Features
Have an idea for a new feature or improvement? Open a GitHub Discussion or an issue tagged with enhancement. Describe the use case and why it would be valuable.
Improve Documentation
Documentation improvements are always welcome. This includes:
- Fixing typos or unclear explanations
- Adding new examples or use cases
- Improving the guides for specific LLM providers or databases
- Translating documentation
Contribute Code
Ready to write some code? Here is the process:
- Fork the repository — Create your own fork of MemoriLabs/Memori on GitHub
- Create a branch — Branch off
mainwith a descriptive name (for example,fix/streaming-bugorfeat/redis-support) - Make your changes — Write your code, add tests, and update documentation if needed
- Run the tests — Make sure all existing tests pass and your new tests cover the changes
- Submit a pull request — Open a PR back to the
mainbranch with a clear description of what you changed and why
See the Development Setup guide for instructions on setting up your local environment.
Pull Request Guidelines
When submitting a pull request:
- Keep PRs focused — One feature or fix per PR. This makes review faster and easier.
- Write descriptive commit messages — Explain what changed and why, not just what files were modified.
- Include tests — New features should include tests. Bug fixes should include a test that reproduces the bug.
- Update documentation — If your change affects the public API or user-facing behavior, update the relevant docs.
- Follow existing patterns — Look at how existing code is structured and follow the same conventions.
Code of Conduct
We are committed to providing a welcoming and inclusive experience for everyone. All contributors are expected to be respectful and constructive in their interactions. Harassment, discrimination, and toxic behavior are not tolerated.
Please review the project's Code of Conduct on the GitHub repository before contributing.
Community
Join the Memori community:
- GitHub Issues — For bug reports and feature requests: github.com/MemoriLabs/Memori/issues
- GitHub Discussions — For questions, ideas, and general conversation: github.com/MemoriLabs/Memori/discussions