Skip to content

Contributing to paiOS

Thank you for your interest in paiOS! The project is building a local-first AI ecosystem and welcomes your help to make it a reality.

Everyone! Whether you are a senior developer or a junior developer 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: The core engine is Rust. Experts and learners alike are welcome.
  • 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. CLA & Licensing - How we handle legal and licensing.

Thank you for being part of the paiOS mission! 🚀