Help & Documentation
Everything you need to master Python with Pytrix. Learn about features, shortcuts, AI integration, and best practices.
About Pytrix
What Pytrix is, why it exists, and how it helps you practice Python with real code execution and AI support.
Adaptive Auto Mode
Automatically identifies your weak spots and builds a personalized practice queue.
Local Python Runtime
Executes code instantly in your browser using Pyodide (WebAssembly).
Privacy by Design
Your API key and history never leave your device.
Uncapped Potential
No fixed curriculum. Infinite variations of any problem type.
What Pytrix is NOT
- It is not a hosted competitive programming platform (like LeetCode's server).
- It is not a static tutorial site; you learn by doing.
- It is not storing your data on a cloud database.
Getting Started
Step-by-step setup: get your API key, configure the app, and start your first practice session.
Get Your Free Gemini API Key
Visit Google AI Studio to generate a free API key. This empowers Pytrix to create questions and provide feedback.
Configure Pytrix
Enter your API key in the Pytrix settings. It is validated and stored locally in your browser.
Choose Your Path
Start with 'Manual Practice' to drill specific topics, or launch 'Auto Mode' for a guided, adaptive session.
Curriculum & Modules
Understanding the Module → Subtopic → Archetype hierarchy and how to navigate the content library.
Pytrix organizes Python concepts into a structured but flexible hierarchy.
High-level categories like "Strings", "Lists", or "OOP". Pytrix includes a core set of modules covering standard Python topics.
Specific concepts within a module. E.g., inside "Strings", you find "Slicing", "Formatting", and "Methods".
Concrete problem patterns. E.g., "Reverse a string" or "Find max in list". You can practice a specific pattern endlessly.
Practice Modes
Deep dive into Manual Practice for precision and Auto Mode for adaptive, flow-state learning.
Complete control. Select exactly what you want to practice.
- Drill specific Modules, Subtopics, or Archetypes
- Force a Difficulty (Beginner/Intermediate/Advanced)
- Deep linking support—share a specific problem setup
- Great for: Homework, targeted revision, debugging specific skills
Flow state. Let Pytrix decide what you need.
- Analyzes which topics you are weakest in
- Builds a dynamic queue of mixed topics
- Increases difficulty after streaks of correct answers
- Smart Buffering: Loads the next question while you code
- Great for: Daily practice, general fluency, warming up
Adaptive Intelligence
Streak-Based Progression
In Auto Mode, answering 2-3 questions correctly in a row triggers a difficulty increase. Struggling with a concept will lower the difficulty or offer remediation.
Session Resume
Auto Mode sessions are saved automatically. You can close the tab and resume your "Run" later from where you left off.
Command Center
Master the global command palette (⌘K) for fast navigation, search, and power actions.
The Command Center is the power-user's heart of Pytrix. Access it anywhere with ⌘K (Mac) or CtrlK (Windows).
• Navigation: Jump to Dashboard, Stats, or Settings.
• Deep Search: Type "List" to see the Module "Lists", Subtopics like "List Slicing", and Archetypes like "Filter a List".
• Quick Actions: Toggle Theme, clear history, or reset state.
• Smart Suggestions: Shows "Practice Weakest Subtopic" based on your actual stats.
Try it now!
Stats & Progress
How we measure your mastery, track your history, and help you visualize your improvement over time.
Pytrix tracks metrics locally to visualize your growth.
A composite score derived from your success rate and difficulty level across all topics.
Identifies modules where you have high failure rates or low attempt counts. Auto Mode targets these.
Every code execution is logged. You can review past solutions and AI feedback from the History page.
API & LLM Usage
How the BYOK (Bring Your Own Key) model works, data privacy, and understanding token usage.
Pytrix acts as a Local Client for the Gemini API.
- You provide the key.
- Google provides the intelligence.
- Pytrix provides the interface and runtime.
- Topic constraints (e.g., "Create a list problem")
- User Code (only when you click "Check with AI")
- Your API Key (in transit only, for authentication)
- Your dashboard stats or history
- Personal identity information
- Browser cookies or local files
Free Tier & Limits
Managing quotas, avoiding rate limits, and dealing with 'Resource Exhausted' errors.
Tips for smooth practice:
- Use Run Code (⌘+Enter) frequently. It uses the local runtime and costs 0 API tokens.
- Only use Check with AI when you are ready to submit or stuck.
- Auto Mode creates a buffer to mask network latency and API limits.
Settings & Customization
Configuring themes, editor fonts, difficulty defaults, and managing your API key.
Customize your experience in Settings.
Privacy & Security
Where your data lives (spoiler: on your device) and what is sent to Google.
We designed Pytrix to be privacy-preserving by default. We do not track you. We do not use analytics cookies.
The only external connection is to generativelanguage.googleapis.com (Google Gemini) to generate questions.
Keyboard Shortcuts
All the hotkeys to navigate Pytrix like a pro without lifting your hands from the keyboard.
Search modules, navigate, or run commands
Show/hide the main navigation sidebar
Execute code and validate with AI
Save snapshot to history (auto-saved on run)
Via Command Center
Start a session instantly
Known Limitations
Current constraints of browser-based Python and occasional AI quirks.
The first time you run code, the Python runtime must download (~10-20MB). This can take a few seconds. Subsequent runs are instant.
Rarely, the AI might generate a question with a subtly incorrect solution. If a question seems impossible or wrong, you can skip it or regenerate.
FAQ & Troubleshooting
Quick answers to common questions about keys, code execution, and bug reporting.
Still have questions?