Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
82 lines (61 loc) · 3.31 KB

CONTRIBUTING.md

File metadata and controls

82 lines (61 loc) · 3.31 KB
Raw

Contributing to PantheonOS

Thanks for your interest in contributing to PantheonOS, an open-source, evolvable, multi-agent framework for the life sciences. Contributions of every kind are welcome: bug reports, documentation, new skills and agents for the Pantheon Store, and core framework improvements.

By participating, you agree to abide by our Code of Conduct.

Where to start

Good first contributions are labeled good first issue in the issue tracker. If you are unsure where to begin, start a thread in Discussions and a maintainer will help point you in the right direction.

Ways to contribute

  • Report bugs. Open an issue with a minimal reproducible example, your environment (OS, Python version, pantheon-agents version), and the expected vs. actual behavior.
  • Improve documentation. Fixes to the docs under docs/ are always welcome and are a great first PR.
  • Contribute skills, agents, and teams. The Pantheon Store is community driven. See the docs for how to package and submit a skill.
  • Improve the core framework. For anything non-trivial, please open an issue or a Discussion first so we can agree on the approach before you invest time.

Development setup

Install the released package:

pip install pantheon-agents

Or work from source:

git clone https://github.com/aristoteleo/PantheonOS.git
cd PantheonOS
pip install -e ".[dev]"

Please run the test suite and any linters before opening a pull request.

Pull request process

  1. Fork the repository and create a topic branch from main.
  2. Make your change, with tests where applicable, and update the docs if behavior changes.
  3. Ensure the test suite passes locally.
  4. Open a pull request against main with a clear description of the change and the motivation. Link any related issue.
  5. A maintainer will review your PR. Please be responsive to feedback; small, focused PRs are reviewed fastest.

All contributions are made under the project's BSD-2-Clause license.

Agent-authored contributions

PantheonOS is a self-evolving system, and some contributions are generated by Pantheon's own agents (for example, through Pantheon-Evolve). We treat this as a governed engineering practice, not an unreviewed pipeline:

  • Every agent-authored change is submitted as a normal pull request and is reviewed and approved by a named human maintainer before it is merged.
  • Agent-authored PRs are labeled as such and include the evidence behind the change (benchmarks, cost, correctness checks) so reviewers can evaluate it.
  • The same quality bar, tests, and Code of Conduct apply to agent-authored and human-authored contributions alike.

Questions

Open a thread in Discussions or reach the maintainers at wzxu@stanford.edu.