By PESU, for PESU 💙
A growing community of developers, tinkerers, and enthusiasts building open-source tools for students at PESU.

We design and maintain open-source projects that students, clubs, and communities at PESU actually use. Some highlights include:

• 🔑 PESUAuth – Authentication API used by the PESU Discord server and other clubs/servers
• 🐍 pesuacademy-py – A Python wrapper for PESU Academy, offering read-only access to the platform
• 🔐 PESU OAuth2 – OAuth2 interaction layer to support application development across clubs and groups
• 🤖 askPESU – A QA bot for PES students
• 🌐 PESU-API – A set of APIs built on top of our existing projects, powering many of our tools
• 🔗 Auth Link Portal – A website built for verification of students into the PESU Discord server

• ❌ We are not a club, and we're not officially affiliated with PES University
• 👨‍🎓 Run by alumni and students, open to anyone who wants to contribute
• 🌱 Started as side projects by a few people (Rowlet from Reddit & Han from Discord), now grown into a welcoming dev space with contributors across batches (yes, even 2029 batch 👀)

• 🐣 Beginner friendly → Many of our tasks require little to no prior experience
• 🧑‍🏫 Mentorship → Alumni & seniors guide you so you're never stuck
• ⚙️ Real-world SWE practices → Git, PRs, CI/CD, staging/production — just like industry
• 🎯 Impact → The stuff you build here is used by hundreds of PESU students and communities

We ❤️ contributions of all kinds — whether that's writing code, improving docs, sharing ideas, or helping others get started. Here's how you can get involved:

1. Join PESU Discord

   • 💬 Join the community → PES University Discord
   • 🛠️ Get the @DevEngineer role → That's how you access PESU-Dev discussions
   • 👋 Say hi! → Ping a maintainer or drop a hello in #pesu-dev

2. Check the Project Board → We maintain an organization-wide project board that tracks:

   • 🔎 Open issues and backlog items
   • ⚡ Ongoing projects
   • 📊 Progress updates on each task

   👉 New contributors should start by going through the Backlog section to see what's available.

3. Pick something that interests you → Find a task that excites you, matches your skills, or seems like a good learning opportunity.

4. Join the conversation → Each project has its own channel on the PESU Discord.

   • Post in the respective channel to express your interest.
   • Maintainers and current contributors will guide you on how to get started.

5. Make your contribution →

   • Fork the repo, create a branch, and start hacking ✨
   • Follow the project's guidelines documented in its CONTRIBUTING.md file

6. Collaborate & Learn → Don't hesitate to ask questions, pair up with others, or request mentorship. PESU-Dev is built on peer collaboration!

• 💻 Code (features, bug fixes, tests)
• 📖 Documentation & tutorials
• 🎨 Ideas, design & feedback
• 🤲 Helping newcomers get onboarded
• 🛠️ Building integrations & extending APIs

• 🐧 Linux or macOS → All projects are developed and tested on Unix-based systems.
  • On Windows, you can use WSL2 or dual boot Linux.
• 🌱 Version Control Basics → You must be familiar with Git & version control.
  • At the very least, go through the MIT Missing Semester: Version Control lecture.
  • (Highly recommended: the entire Missing Semester course).
• 📝 Code Editor/IDE → Install your favorite editor (VS Code, Neovim, JetBrains, etc).
• 🔑 Git Setup → Make sure you have Git installed and configured on your system. You'll also need Git with SSH authentication set up to interact with our repositories; follow this guide: How to Set Up Git SSH.