Platform documentation
Guides for learning with 1Percent — from your first visit to your first certificate.
Getting Started
How to join 1Percent: create a free account, confirm your email, and start your first lesson in minutes.
How to Use 1Percent
The complete beginner guide: lessons, labs, challenges, coins, streaks, and certificates explained step by step.
Courses
Browse every 1Percent course — from Programming Fundamentals and Python to React, DevOps, and Robotics.
Pricing
How much does it cost to learn with 1Percent? Free, Pro (RWF 15,000/mo) and Unlimited (RWF 35,000/mo) compared.
Payments
How to pay: MTN MoMo and Airtel Money via *182#, bank transfer, or card — with parent payment links.
Installation
Install the VS Code extension and CLI, with system requirements and step-by-step setup.
FAQ
Frequently asked questions about 1Percent — cost, free tier, joining, courses, and payments.
Quick Start
Choose your tool and get started in minutes.
1% Learn CLI
Upload files, download lessons, and manage your lab from the command line. Works on macOS, Linux, and Windows.
VS Code Extension
View challenges in your editor, submit solutions with one keystroke, and track your progress — all without leaving VS Code.
Web Lab
Use the online lab at 1percent.rw/learn/lab to code directly in your browser.
1% Learn CLI
A powerful command-line tool for managing your learning files and courses.
Install the CLI
-
Install via npm
Install the CLI globally on your system:
bashnpm install -g @1percent/learn-cli
-
Verify installation
Check that the CLI is installed correctly:
bashonepercent --version
-
Login to your account
Authenticate with your 1% Learn credentials:
bashonepercent login
onepercent login --api https://localhost:3000
Authentication
The CLI stores your authentication token locally. You only need to login once.
# Login with email and password onepercent login # Login with inline credentials onepercent login -e you@example.com -p mypassword # Check current user onepercent whoami # Logout onepercent logout
~/.config/1percent-learn-cli/. Never share this file.
File Management
Upload, download, and manage your lab files from the terminal.
# Upload a file to your lab onepercent upload app.js onepercent upload main.py onepercent upload index.html # Upload with a custom name onepercent upload script.js -n my-script.js # List all your files onepercent ls # Pull a file from your lab onepercent pull app.js onepercent pull app.js -o local-copy.js # Delete a file onepercent rm old-file.js onepercent rm old-file.js -y # skip confirmation
.js .py .html .css .json .md .ts .sh
Course Downloads
Download course lessons for offline learning.
# Download a specific lesson onepercent download -f "programming-fundamentals" -l 1 # Download lessons 1-3 onepercent download -f "git-github" -l 1:3 # Download all lessons (requires premium) onepercent download -f "command-line-linux" -l : # List lessons in a course onepercent download -f "backend-development" --list # Download to a custom directory onepercent download -f "databases" -l 1 -o ./my-notes
VS Code Extension
Solve coding challenges directly in your code editor.
-
Download and Install the VSIX
Click the button above to download
onepercent-learn-vscode-1.0.0.vsix, then install it directly from your terminal or VS Code:bashcode --install-extension onepercent-learn-vscode-1.0.4.vsix
-
Login
Open Command Palette (
Ctrl+Shift+P) and run1% Learn: Login -
Browse challenges
Open the Explorer sidebar and expand "1% Learn Challenges" to see available challenges grouped by difficulty.
-
Submit your solution
Write your code, then press
Ctrl+Shift+Enterto submit. Select the challenge and view your results.
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Ctrl+Shift+Enter | Submit current file as solution |
| Ctrl+Shift+P → "1% Learn" | Access all extension commands |
Commands Reference
Complete list of all CLI commands.
| Command | Description |
|---|---|
| onepercent login | Log in to your 1% Learn account |
| onepercent logout | Log out and clear stored credentials |
| onepercent whoami | Show current user info |
| onepercent upload <file> | Upload a file to your lab |
| onepercent pull <filename> | Download a file from your lab |
| onepercent ls | List all files in your lab |
| onepercent rm <filename> | Delete a file from your lab |
| onepercent premium | Check your premium status and limits |
| onepercent premium --tiers | Show all available subscription plans |
| onepercent download -f <course> -l <lesson> | Download course lessons |
| onepercent download -f <course> --list | List all lessons in a course |
| onepercent project new <name> | Create a new project folder |
| onepercent project ls | List your project folders |
FAQ
What file types are supported?
Free users can upload .js, .py, .html, .css, .json, .md, .txt, and .sh files. Premium users get access to TypeScript, JSX/TSX, YAML, SQL, and more.
How many files can I store?
Free tier: 5 files (2MB). Starter: 5 files (2MB). Pro: 10 files (5MB). Unlimited: 999 files (20MB).
Can I use the CLI with a local development server?
Yes! Use onepercent login --api http://localhost:3000 to connect to a local server.
How do I reset my password?
Visit 1percent.rw/reset-password or use the "Forgot Password" link on the login page.
Is the VS Code extension free?
Yes! The extension is completely free. You just need a 1% Learn account (free tier works).