Skip to content

Latest commit

 

History

History
100 lines (78 loc) · 2.49 KB

CONTRIBUTING.md

File metadata and controls

100 lines (78 loc) · 2.49 KB

Contributing to LangManus

Thank you for your interest in contributing to LangManus! We welcome contributions of all kinds from the community.

Ways to Contribute

There are many ways you can contribute to LangManus:

  • Code Contributions: Add new features, fix bugs, or improve performance
  • Documentation: Improve README, add code comments, or create examples
  • Bug Reports: Submit detailed bug reports through issues
  • Feature Requests: Suggest new features or improvements
  • Code Reviews: Review pull requests from other contributors
  • Community Support: Help others in discussions and issues

Development Setup

  1. Fork the repository
  2. Clone your fork: 
    git clone https://github.com/your-username/langmanus.git
cd langmanus
  3. Set up your development environment: 
    uv sync --all-extras
uv run playwright install
  4. Configure pre-commit hooks: 
    chmod +x pre-commit
ln -s ../../pre-commit .git/hooks/pre-commit

Development Process

  1. Create a new branch:

    git checkout -b feature/amazing-feature

  2. Make your changes following our coding standards:

    • Write clear, documented code
    • Follow PEP 8 style guidelines
    • Add tests for new features
    • Update documentation as needed

  3. Run tests and checks:

    make test      # Run tests
make lint      # Run linting
make format    # Format code
make coverage  # Check test coverage

  4. Commit your changes:

    git commit -m 'Add some amazing feature'

  5. Push to your fork:

    git push origin feature/amazing-feature

  6. Open a Pull Request

Pull Request Guidelines

  • Fill in the pull request template completely
  • Include tests for new features
  • Update documentation as needed
  • Ensure all tests pass and there are no linting errors
  • Keep pull requests focused on a single feature or fix
  • Reference any related issues

Code Style

  • Follow PEP 8 guidelines
  • Use type hints where possible
  • Write descriptive docstrings
  • Keep functions and methods focused and single-purpose
  • Comment complex logic

Community Guidelines

  • Be respectful and inclusive
  • Follow our code of conduct
  • Help others learn and grow
  • Give constructive feedback
  • Stay focused on improving the project

Need Help?

If you need help with anything:

  • Check existing issues and discussions
  • Join our community channels
  • Ask questions in discussions

We appreciate your contributions to making LangManus better!