Soplang Logo
Soplang
Open Source & Community Driven

Contribute to Soplang

Soplang is built by people like you. Whether you write code, improve documentation, or help others, every contribution makes a difference.

Read GuidelinesVisit Repository

Ways to Contribute

Code

Fix bugs, optimize performance, or build new features for the compiler and interpreter.

Documentation

Improve guides, fix typos, and write tutorials to help new users learn Soplang.

Community

Answer questions, help beginners, and share your Soplang projects with the world.

Hall of Fame

A huge thanks to our amazing contributors who make Soplang possible.

sharafdin
300
sharafdin
shiinedev
17
shiinedev
juweyriyo
15
juweyriyo
Nasrah-muse
9
Nasrah-muse
Adam-Elmi
9
Adam-Elmi
Abdiladiif-Abdisamed
8
Abdiladiif-Abdisamed
star-Elmi
7
star-Elmi
omartood
7
omartood
AishaKeyf
5
AishaKeyf
mohamedsahal
2
mohamedsahal
iftiiin
2
iftiiin
Alimoha-1
1
Alimoha-1
moelkenzi
1
moelkenzi
DevMuna
1
DevMuna

Want to see your face here? Start contributing!

Development Setup

There are two recommended ways to set up your development environment. We recommend using Docker to eliminate "works on my machine" issues.

Option 1 (Recommended)

Docker Setup

1. Clone the repository:

Terminal
git clone https://github.com/soplang/soplang.git
cd soplang
docker-compose build
docker-compose up -d

2. Run commands inside the container:

Terminal
# Run the shell
docker-compose exec soplang python main.py

# Run tests
docker-compose exec soplang python -m unittest discover tests
Option 2

Local Setup

Prerequisites: Python 3.6+, Git

Terminal
git clone https://github.com/soplang/soplang.git
cd soplang

# Create virtual env (Recommended)
python -m venv env
source env/bin/activate  # On Windows: env\Scripts\activate

# Install dependencies
pip install -r requirements-dev.txt

Security Policy

Found a vulnerability? Please do NOT open a GitHub issue.

Report to security@soplang.org