Thank you for your interest in contributing to Llama Metasearch! This document provides guidelines and instructions for contributing to this project.
Please read and follow our Code of Conduct.
There are many ways to contribute to Llama Metasearch:
- Report bugs: Submit issues for any bugs you encounter.
- Suggest features: Submit issues with feature requests or enhancement ideas.
- Improve documentation: Help improve the documentation by fixing typos, clarifying explanations, or adding examples.
- Contribute code: Submit pull requests with bug fixes, features, or improvements.
- Python 3.8 or higher
- Git
-
Fork the repository by clicking the "Fork" button on the top-right of the repository page.
-
Clone your fork:
git clone https://github.com/YOUR_USERNAME/llama-metasearch.git cd llama-metasearch -
Set up the upstream remote:
git remote add upstream https://github.com/llamasearchai/llama-metasearch.git
-
Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install development dependencies:
pip install -e ".[dev]" -
Run tests:
pytest
- Pull requests should focus on a single feature or fix.
- Include tests for any new functionality or bug fixes.
- Update documentation to reflect any changes in public API or behavior.
- Follow the existing code style and conventions.
- Keep your pull request up-to-date with the main branch.
We follow standard Python conventions:
- Use Black for code formatting.
- Follow PEP 8 style guidelines.
- Use Google-style docstrings.
- Add type hints for function parameters and return values.
By contributing to Llama Metasearch, you agree that your contributions will be licensed under the project's MIT License.