Contributing

Ways to contribute

Code contributions

Fix bugs, add features, improve performance.

1. Fork the repository on GitHub
2. Create a feature branch
3. Make your changes with tests
4. Submit a pull request

Domain expertise

You don't need to write code to contribute. Maritime professionals can:

• Review agent workflows for operational accuracy
• Suggest missing operational patterns
• Validate compliance requirements
• Test deployments and report issues

Documentation

Help make our docs better:

• Fix errors or unclear explanations
• Add examples and tutorials
• Translate documentation
• Write guides for specific use cases

Testing

• Report bugs with reproduction steps
• Test on different environments and configurations
• Validate agent behavior in edge cases

Getting started

# Clone the repository
git clone https://github.com/metaweavehq/lifeverse-ai.git
cd lifeverse-ai

# Install dependencies
python3 install.py

# Run tests
python3 -m pytest tests/

# Make your changes and submit a PR

Pull request guidelines

• Keep PRs focused — one feature or fix per PR
• Add tests for new functionality
• Update docs if behavior changes
• Follow existing patterns — look at how similar code is structured
• Write clear commit messages — explain why, not just what

Issues

• Bug reports: Include steps to reproduce, expected vs actual behavior, and environment details
• Feature requests: Describe the use case, not just the solution
• Questions: Use GitHub Discussions for general questions

Communication

• GitHub Issues: Bug reports and feature requests
• GitHub Discussions: General questions and ideas
• Email: hello@appliedaifoundation.org for partnership and non-technical inquiries