You scanned the poster. Hi.
Come break Asomiya.
Asomiya is a programming language in Assamese, built by three students from Assam. It works, but it needs people who poke it, break it and make it better. No experience needed for most of this.
- Tester
The Breaker
Write small programs, try weird things, tell us what felt wrong.
- Security researcher
The Hacker
Find a way to crash, freeze or escape the interpreter or the playground.
- Contributor
The Builder
Fix bugs, add features, improve the docs or this website.
- Assamese speaker
The Wordsmith
Tell us if a keyword or an error message doesn’t sound like real Assamese.
Test it (5 minutes)
- Open the playground and run the examples. No install needed.
- Follow the quick start and write your own program, in Assamese script or English letters.
- Something confusing, broken or ugly? Open an issue and tell us what you typed and what happened.
Feedback we especially want: Was anything confusing? Which error message didn’t help? What would you build with it?
Security research
Asomiya runs other people’s code: in the browser playground, in the terminal, and inside apps that use the npm package. We have tried hard to make that safe. Prove us wrong.
In scope
- The interpreter: escaping the sandbox, reading files or the network, crashing or hanging Node.js
- Denial of service from a single program or input (we already fixed one; find the next)
- The playground at asomiya.codes: script injection, share-link tricks, getting around the Content Security Policy
- Hidden-code tricks (Trojan Source), terminal escape sequences, look-alike names
- The asomiya npm package and its CLI
Please don’t
- Attack GitHub, npm or other people’s accounts or infrastructure
- Flood the website with traffic: test the playground on your own machine instead (
npm run website:serve) - Make a vulnerability public before we have had a chance to fix it
How to report
Report privately through private vulnerability reporting on GitHub. Include the program or steps that trigger it and what you expected. We aim to reply within a week, and we will credit you in the changelog and SECURITY.md unless you prefer to stay anonymous.
Contribute code
- Read CONTRIBUTING.md: how the project is organised and how to run the tests.
- Pick an issue on GitHub, or suggest your own idea first.
- Ideas we would love help with: a for-each loop, more built-in functions (text and lists), syntax highlighting for VS Code, and lessons for school students.
The code is TypeScript with more than 330 tests. Every change runs them on Linux, macOS and Windows.
Help with the words
Some keywords are still provisional, like যেতিয়ালৈকে (while), ফাংচন (function) and ঘূৰাইদিয়া (return). If you know a more natural Assamese word, or a romanised spelling we missed, Open an issue. The full list is in the keyword reference.
Who to talk to
Debashish Bordoloi, Arnab Sharmah and Siddhartha Borah. Find us on the Community page.