FOSSASIA

Your OpenVeda Playbook

FOSSASIA Logo

OpenVeda Playbook: FOSSASIA

Your complete guide to joining Asia's largest and most diverse open-source community. Find your project, find your people.


1. The "Why": Building for Asia, with Asia

  • The Mission: To develop and adapt open-source technologies for social change, with a powerful focus on the unique challenges and opportunities within Asia.
  • Your Impact: Your work has a direct line to real-world use. The Open Event platform runs major tech conferences. SUSI.AI is an active chatbot project. This is not theoretical software.
  • Why it's a Career Supercharger: FOSSASIA is a "meta-organization" that participates in every major program: GSoC, GSoD, Outreachy, and more. Success here shows you are a versatile, adaptable developer who can thrive in a fast-paced, multicultural, and highly distributed team.

2. The "What": A Universe of Technology

FOSSASIA is a constellation of projects. You can find almost any tech stack here.

  • Flagship Project (Web): Open Event (open-event-server, open-event-frontend). Stack: Python (Flask), JavaScript (React, Ember.js).
  • Flagship Project (AI): SUSI.AI. Stack: Java (Server), Kotlin (Android), React (Web).
  • Flagship Project (Hardware/DevOps): pslab.io (Pocket Science Lab). Stack: Python, Go.
  • Rising Star (Social Media): LOKLAK. Stack: Java/Kotlin (Android), Swift (iOS). A decentralized P2P social network.
  • General Tooling: GitHub Actions, Docker, and a strong culture of unit and integration testing.

3. The "How": Your Complete FOSSASIA Onboarding Journey

3.1: Immerse in the Community

  • Primary Channel (Gitter): The central nervous system of FOSSASIA.
  • Project-Specific Channels: Once you pick a project (like Open Event), join its specific Gitter channel for focused help.

3.2: The Foolproof Environment Setup (Example: Open Event Server)

We'll use their most popular project as an example.

  1. Prerequisites: Git, Python3, pip, and PostgreSQL.
  2. Fork & Clone: Fork open-event-server on GitHub and clone your fork.
  3. Setup Virtual Environment: cd open-event-server, then python3 -m venv venv and source venv/bin/activate.
  4. Install Dependencies: pip install -e .
  5. Create Database: psql -c "create database open_event;"
  6. Initialize Database: python manage.py db upgrade
  7. Run Server: python manage.py runserver
  8. Access: http://127.0.0.1:5000.
  • Troubleshooting: The #1 issue is missing PostgreSQL system libraries (like libpq-dev on Ubuntu/Debian).

3.3: The Contribution Workflow (The FOSSASIA GitHub Flow)

  1. Find & Claim an Issue: Find a "good first issue" and comment to get assigned.
  2. Sync Your Fork: Keep your fork up-to-date with the development branch of the main repository.
  3. Create a Feature Branch: git checkout -b feature/your-awesome-fix
  4. Code & Test: Write your code. Crucially, run the tests (python manage.py test). A PR with failing tests will likely be rejected.
  5. Commit & Push: Commit with a clear message and push to your fork.
  6. Open a Pull Request: Target the development branch. Write a clear description and link the issue.
  7. Engage in Review: FOSSASIA mentors are very responsive. Engage with their feedback, make updates, and push new commits.

4. GSoC History & Focus Areas

  • Historical Focus: FOSSASIA is one of the largest GSoC organizations. They have hundreds of project ideas every year, spanning web, mobile, AI, hardware, and firmware.
  • What Mentors Look For: Proactiveness. They want to see you active on Gitter, helping others, and making small contributions before the GSoC application period. They value community members, not just coders. A history of asking good questions is a plus.

5. Key Repositories to Know


6. Find Your First Task Right Now


7. The Unwritten Rules (Mentor Insights)

  • Activity is Everything: Your visibility on Gitter is almost as important as your code.
  • Ask Smart Questions: Don't just say "it's not working." Post your error logs, explain what you tried, and what you expected to happen.
  • Review Others' Code: A fantastic way to learn and get noticed is to politely review other newcomers' pull requests. Leave helpful comments and suggestions. It shows you're a true community player.

Stuck? Get Unstuck. Now.

As the founder of OpenVeda, I'm personally offering free 1-on-1 help sessions. Book a 15-minute slot with me and let's solve your problem together.

Book a Free Session with Ayush