Skip to content

Contributing to paiOS

Thank you for your interest in paiOS! We are building a local-first AI ecosystem, and we need your help to make it a reality.

Everyone! Whether you are a Senior Developer or a Junior starting your journey, your help is valued.

We value quality and simplicity. You are welcome to use AI tools (like Cursor or Copilot), provided the final code follows our standards. Most importantly: have fun!

  • AI & ML Enthusiasts: Help us run models (VLMs, audio) on local hardware.
  • Rust Developers: Our core engine is Rust. We need experts and learners alike.
  • OS Builders: Improve our Debian-based OS and build recipes.
  • Designers: Help with hardware design, icons, and UI/UX.
  • Testers & Architects: Help us find bugs or design a better system.
  • Generalists: If you like working across the whole stack, you’re in the right place.

Don’t see your role listed? Reach out anyway! Every contribution counts.

If you have questions, found a bug, or need clarification, please reach out:

Follow these guides to start contributing:

  1. Contribution Workflow - Step-by-step guide to making your first change.
  2. Development Standards - Our core principles (KISS, SOLID, Clean Code).
  3. AI-Assisted Development - How to use AI tools and TaskMasterAI effectively.
  4. Project Roles & Maintainers - How the team is organized.
  5. DCO & Licensing - How we handle legal and licensing.

Thank you for being part of the paiOS mission! 🚀