terminal-tutor

Name	terminal-tutor JSON
Version	0.1.2 JSON
	download
home_page	https://github.com/jatinmayekar/terminal-tutor
Summary	Real-time terminal command education for Zsh - 1.6ms avg predictions, 459+ commands, 100% tested (Zsh required)
upload_time	2025-10-27 03:41:28
maintainer	None
docs_url	None
author	Jatin Mayekar
requires_python	>=3.7
license	Proprietary
keywords	terminal cli learning commands tutorial zsh shell education real-time
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Terminal Tutor 🚀

> ⚖️ **License Notice**: Terminal Tutor is proprietary software. Personal, non-commercial use permitted. Commercial/enterprise use requires a paid license. Unauthorized distribution or modification may result in legal action including statutory damages up to $150,000 per violation. See [LICENSE](LICENSE) file for full terms.

> **World's first real-time command education tool** - Learn terminal commands as you type with instant descriptions, safety warnings, and intelligent suggestions!

[![Production Ready](https://img.shields.io/badge/Status-Production%20Ready-brightgreen)](https://github.com/jatinmayekar/terminal-tutor)
[![Tests](https://img.shields.io/badge/Tests-116%2F116%20Passing-brightgreen)](tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md)
[![Performance](https://img.shields.io/badge/Performance-1.6ms%20avg-blue)](tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md)
[![Commands](https://img.shields.io/badge/Commands-459+-orange)](https://github.com/jatinmayekar/terminal-tutor)
[![Shell Support](https://img.shields.io/badge/Shell-Zsh%20Required-purple)](https://github.com/jatinmayekar/terminal-tutor)
[![License](https://img.shields.io/badge/License-Proprietary-red)](LICENSE)

## 🎯 What Makes Terminal Tutor Revolutionary?

Terminal Tutor is the **first and only** terminal education tool that provides **real-time command descriptions** as you type - literally keystroke by keystroke. No more waiting, no more guessing, no more dangerous mistakes.

### ⚡ **Real-Time Magic in Action**

```bash
# As you type "git st" - predictions appear instantly:
$ git st█                           # ← You're typing here
🟢 SAFE - Show working tree status   # ← Live prediction appears below
```

**Performance**: 1.4-2.0ms response time (96% faster than target!) ⚡

## ⚠️ **Requirements** - Install Zsh First!

**REQUIRED:**
- ✅ **Zsh shell** - Real-time predictions ONLY work in Zsh (Bash/Fish not supported yet)
- ✅ **Python 3.7+** - Python runtime required
- ✅ **macOS/Linux** - Native Unix support
- ✅ **Windows** - Via Git Bash or WSL2 (native PowerShell coming 2026)

### **Step 1: Check if you have Zsh installed**

```bash
# Check if Zsh is installed:
which zsh

# ✅ If it shows: /bin/zsh or /usr/bin/zsh → Zsh is installed! Go to Step 2
# ❌ If it shows: nothing or "zsh not found" → Install Zsh in Step 2
```

### **Step 2: Install Zsh (if needed)**

```bash
# macOS (Zsh pre-installed on macOS 10.15+)
# Skip to Step 3!

# Ubuntu/Debian/Linux Mint
sudo apt update && sudo apt install zsh

# Fedora/RHEL/CentOS
sudo dnf install zsh

# Arch Linux
sudo pacman -S zsh
```

### **Step 3: Switch to Zsh**

**Option A: Try Zsh NOW (temporary - recommended for testing)**
```bash
zsh
# ↑ You're now in Zsh! Perfect for testing Terminal Tutor.
# To exit Zsh and return to your previous shell, type: exit
```

**Option B: Make Zsh your DEFAULT shell (permanent)**
```bash
chsh -s $(which zsh)
# ⚠️ Will ask for your password (your macOS/Linux login password - this is normal!)
# ℹ️ If you see "no changes made" → You're already on Zsh! Success!
# Close terminal and reopen → You'll be in Zsh automatically

# Verify it worked:
echo $SHELL  # Should show: /bin/zsh
```

**💡 Recommended:** Try Option A first to test Terminal Tutor, then use Option B to make it permanent if you like it!

## 🚀 **Quick Start** (2 minutes to awesome)

**Step 1: Install with uv (recommended)**
```bash
# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install Terminal Tutor with uv
uv tool install terminal-tutor
```

**Alternative: Install with pipx**
```bash
# If you prefer pipx
pipx install terminal-tutor
```

**Step 2: Activate real-time predictions**
```bash
# Activate the magic (adds to ~/.zshrc)
terminal-tutor install

# Restart Zsh to load integration
exec zsh
```

**Step 3: Test it works!**
```bash
# Start typing slowly... watch predictions appear!
git st█
# You should see: 🟢 SAFE - Show working tree status

# Verify installation
terminal-tutor status
# Should show: 🟢 Enabled
```

**You're now a command-line wizard! ✨**

## 🌟 **Core Features**

### 🔮 **Real-Time Predictions** (Zsh - World First!)
- **Keystroke-by-keystroke** command education
- **1.4-2.0ms** lightning-fast response time (avg 1.6ms)
- **Live descriptions** appear as you type
- **Zero latency** user experience

### 🧠 **Intelligent Fuzzy Matching**
- **State-of-the-art algorithm** with exponential position decay
- **Surgical precision** - no irrelevant suggestions
- **Context-aware** recommendations
- **FZF-inspired** smart scoring

```bash
# Smart suggestions for partial input (use debug for performance metrics)
$ terminal-tutor debug "git s"
───────────────────────────────────
🟢 SAFE git status - Show the working tree status
🟡 CAUTION git stash - Stash changes in a dirty working directory
🟢 SAFE git show - Show various types of objects
───────────────────────────────────
⏱️  1.2ms | 📊 3 matches | 🔍 fuzzy
```

### 🗣️ **Natural Language Command Discovery**
```bash
# Ask in plain English, get exact commands
$ terminal-tutor ask "how to list files"
ls - 🟢 SAFE - List directory contents

$ terminal-tutor ask "copy files recursively"
cp -r - 🟢 SAFE - Copy directories recursively
```

**First-time setup**: The ask mode requires an OpenAI API key. On first use, you'll be prompted to enter your key. Get one here: https://platform.openai.com/api-keys

```bash
# Configure API key manually
$ terminal-tutor config api-key set

# Check API key status
$ terminal-tutor config api-key status

# Remove stored API key
$ terminal-tutor config api-key clear
```

**Security**: API keys are stored in `~/.terminal_tutor_openai_key` with 600 permissions (user read/write only) and never echoed to the terminal.

### 🛡️ **Advanced Safety System**
- **🟢 SAFE** / **🟡 CAUTION** / **🔴 DANGEROUS** risk levels
- **Smart pattern recognition** for destructive commands
- **Context-aware warnings** with safety prompts
- **False positive elimination** through machine learning

### 📚 **Comprehensive Command Database** (459+ commands)
- **Git**: Complete workflow coverage (13 commands)
- **Docker**: Container lifecycle management (15 commands)
- **Kubernetes**: Cluster operations (13 commands)
- **AWS CLI**: Full cloud platform coverage (96 commands)
- **System Commands**: Unix/Linux essentials (41+ commands)
- **Network Tools**: Connectivity and security (45+ commands)

## 🎭 **Shell Support**

### **Zsh** - Real-Time Predictions (REQUIRED for now)
```bash
# ✅ FULLY SUPPORTED: Real-time predictions with ZLE widgets
# Type naturally, see descriptions instantly (1.4-2.0ms)
# Zero configuration after installation
# This is the ONLY way to experience real-time Terminal Tutor
```

### **Bash & Fish** - Coming Soon
```bash
# ⏳ PLANNED: Real-time support in future releases
# Currently, use Zsh for the full experience
# Bash/Fish users: Install Zsh to use Terminal Tutor
```

## 🎮 **Usage Examples**

### **Daily Development Workflow**
```bash
# Git operations with confidence
$ git rebase -i HEAD~3█
🟡 CAUTION - Interactively rebase commits (can rewrite history)

# Docker deployments made safe
$ docker rm -f $(docker ps -aq)█
🔴 DANGEROUS - Force remove ALL containers (data loss risk)

# Kubernetes with clarity
$ kubectl delete deployment nginx█
🟡 CAUTION - Delete deployment (will terminate all pods)
```

### **Learning New Tools**
```bash
# Explore AWS services with debug (shows performance metrics)
$ terminal-tutor debug "aws s3"
───────────────────────────────────
🟢 SAFE aws s3 ls - List S3 buckets or objects
🟢 SAFE aws s3 cp - Copy files to/from S3
🟡 CAUTION aws s3 sync - Sync directories with S3
───────────────────────────────────
⏱️  1.1ms | 📊 3 matches | 🎯 exact (+ related)

# Discover system commands
$ terminal-tutor ask "monitor system resources"
htop - 🟢 SAFE - Interactive process viewer
```

## ⚙️ **Advanced Management**

### **Debug Command** (New - Unified Diagnostic Tool)
```bash
# Debug with performance metrics - shows timing, match count, and match type
terminal-tutor debug "git"           # Top 3 matches + performance stats
terminal-tutor debug "git status"    # Exact match + timing
terminal-tutor debug "c"             # Fuzzy matching + metrics

# Example output:
───────────────────────────────────
🟢 SAFE git - Distributed version control system
🟢 SAFE git add - Add file contents to the index
🟢 SAFE git log - Show commit logs
───────────────────────────────────
⏱️  1.2ms | 📊 3 matches | 🎯 exact (+ related)
```

**Note**: `explain` and `suggest` commands are deprecated - use `debug` instead.

### **Control Commands**
```bash
# Instant control
terminal-tutor disable   # Pause predictions
terminal-tutor enable    # Resume magic
terminal-tutor toggle    # Smart toggle
terminal-tutor status    # Check state

# Usage insights
terminal-tutor usage     # View daily stats
terminal-tutor premium   # Upgrade options

# Configuration
terminal-tutor config api-key set      # Configure OpenAI API key
terminal-tutor config api-key status   # Check API key status
terminal-tutor config api-key clear    # Remove stored API key
```

### **Custom Commands**
```bash
# Add your own commands to Terminal Tutor
# Create ~/.terminal_tutor_custom_commands.json

{
  "version": "1.0",
  "commands": {
    "deploy-prod": {
      "description": "Deploy to production environment",
      "risk_level": "DANGEROUS",
      "category": "custom"
    },
    "my-build": {
      "description": "Custom build script for my project",
      "risk_level": "SAFE",
      "category": "custom"
    }
  }
}

# Your custom commands will:
# - Override default commands (if same name)
# - Appear in fuzzy search results
# - Work with real-time predictions
# - Show correct risk levels

# Edit default commands database:
# terminal_tutor/data/commands.json (459+ commands)
```

## 💎 **Premium Features**

### **Free Tier** - Forever Free
- **Unlimited real-time predictions** in Zsh
- Complete command database (459+ commands, growing to 1000+)
- All safety warnings and command descriptions
- BYO API key for ask mode (use your own OpenAI key)
- Local LLM support (Ollama integration)
- 7-day local stats history

### **Premium Tier** - $7/month ✨ **NOW AVAILABLE**
- **Zero-setup AI** - No API key configuration needed
- **Cloud-synced stats** - Access from any device with MongoDB Atlas
- **Developer leaderboard** - See how you rank globally among developers
- **Stats dashboard** - Track command usage, learning streaks, favorite commands
- **Team libraries** - Shared command definitions
- **Priority support** - Direct developer access
- **Career stats export** - LinkedIn/resume-ready metrics

**🌐 Preview the Premium Dashboard**: Visit [terminaltutor.dev/dashboard-preview](https://terminaltutor.dev/dashboard-preview) to see what Premium offers!

### **Web Platform Architecture**
The Premium tier is powered by a production-ready web platform:
- **Frontend/Backend**: Next.js 15 with App Router (deployed on Vercel)
- **Database**: MongoDB Atlas (cloud-synced user stats and command history)
- **Authentication**: NextAuth v5 with Google OAuth
- **API Routes**: RESTful endpoints for stats sync and leaderboard
- **Dashboard Components**: Real-time stats visualization with DaisyUI

For deployment documentation, see [`docs/deployment/DEPLOYMENT_GUIDE.md`](docs/deployment/DEPLOYMENT_GUIDE.md)

## 🧪 **Technical Excellence**

### **Performance Benchmarks**
- **Prediction Time**: 1.4-2.0ms avg (target: <50ms) ✅ **96% faster!**
- **Test Results**: 116/116 tests passing across Ubuntu 22.04/24.04 ✅
- **Algorithm Precision**: 100% on critical test cases ✅
- **Memory Usage**: Minimal footprint with intelligent caching
- **Startup Time**: Zero-latency shell integration

### **Architecture Highlights**
- **O(1) prefix tree lookup** for instant command matching
- **Exponential position decay** for fuzzy search precision
- **File-based controls** for real-time performance
- **Graceful degradation** when offline or under load

### **Quality Standards**
- **Security First**: No credential exposure, safe execution
- **Backward Compatibility**: Seamless upgrades
- **Shell Agnostic**: Works across Unix/Linux environments
- **Silent Operation**: No noise, action-first UX

### **Platform Compatibility**

| Platform | Status | Tests | Performance | Notes |
|----------|--------|-------|-------------|-------|
| Ubuntu 22.04 (Zsh) | ✅ Verified | 29/29 | 1.7-1.8ms | 100% pass rate |
| Ubuntu 22.04 + Oh-My-Zsh | ✅ Verified | 29/29 | 1.7ms | Full compatibility |
| Ubuntu 24.04 (Zsh) | ✅ Verified | 29/29 | 1.4ms | ⚡ Fastest |
| Ubuntu 24.04 + Oh-My-Zsh | ✅ Verified | 29/29 | 1.5ms | Full compatibility |
| macOS (Zsh) | ✅ Working | - | 2.0ms | Core functionality verified |
| WSL2 (Ubuntu) | 🟡 Expected | - | - | Should work (Ubuntu compat) |
| PowerShell | 🚧 Planned | - | - | Coming 2026 |

**Total Tests**: 116/116 passing (100% success rate)

**Documentation**: See [tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md](tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md) for detailed test reports.

## 🛠️ **Installation & Setup**

### **System Requirements**
- ✅ **Zsh shell** - REQUIRED (Bash/Fish not supported yet)
- ✅ **Python 3.7-3.13** - Runtime environment
- ✅ **macOS/Linux** - Native Unix support
- ✅ **Windows** - Via Git Bash or WSL2 (native PowerShell coming 2026)
- ✅ **uv or pipx** - Recommended installation tool

### **Production Installation (Recommended)**
```bash
# Method 1: Using uv (fastest, recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install terminal-tutor
terminal-tutor install
exec zsh

# Method 2: Using pipx
pipx install terminal-tutor
terminal-tutor install
exec zsh

# Verify it works
terminal-tutor status  # Should show: 🟢 Enabled
```

### **Development Installation**
```bash
# Clone repository
git clone https://github.com/jatinmayekar/terminal-tutor.git
cd terminal-tutor

# Install in editable mode
uv tool install --editable .
# OR: pipx install --editable .

# Activate
terminal-tutor install
exec zsh

# Test with debug mode
terminal-tutor debug "git"  # Shows performance metrics
```

### **Troubleshooting**

#### **"command not found: terminal-tutor" after pip install**

If you installed with `pip install terminal-tutor` (instead of `uv` or `pipx`) and see this error, the installation directory may not be in your PATH.

**Quick Fix:**
```bash
# Add ~/.local/bin to PATH temporarily
export PATH="$HOME/.local/bin:$PATH"

# Test it works now
terminal-tutor status

# Make it permanent by adding to ~/.zshrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

**Better Solution** - Use `uv` or `pipx` (handles PATH automatically):
```bash
# Uninstall pip version
pip uninstall terminal-tutor

# Reinstall with uv (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install terminal-tutor
```

**Why this happens**: When using `pip install --user`, Python installs to `~/.local/bin`, which may not be in your default PATH on some systems.

---

#### **Real-time predictions not working after install**

If `terminal-tutor install` succeeds but real-time predictions don't appear when typing:

**Check if integration loaded:**
```bash
# Should show tt_predict_realtime and other widgets
zle -la | grep tt_
```

**If empty, manually reload:**
```bash
# Find the integration file
find /usr -name "zsh_integration.zsh" 2>/dev/null

# Source it (use the path from above)
source /usr/local/lib/python3.12/dist-packages/terminal_tutor/zsh_integration.zsh

# Or reinstall
terminal-tutor install
exec zsh
```

**Why this happens**: In some environments (Docker, fresh installs), the shell config file may not exist or the SHELL environment variable may not be set correctly. The latest version creates the file automatically.

## 🌍 **Community & Contribution**

### **Join the Revolution**
- 🌟 **Star us** on GitHub to support development
- 🐛 **Report issues** to help us improve
- 💡 **Suggest features** for future releases
- 📚 **Contribute commands** to expand the database

### **Developer Resources**
- **Documentation**: Complete agent onboarding in `CLAUDE.md`
- **Strategy Docs**: Business strategy and ICP analysis in `docs/strategy/`
- **Deployment Guides**: Production deployment in `docs/deployment/`
- **Research**: Algorithm analysis in `docs/research/`
- **Launch Content**: Marketing content and launch plan in `docs/launch/`
- **Testing**: Beta testing strategy in `evaluation/` folder
- **Roadmap**: Future plans in `TODO.md`

## 🗺️ **Roadmap 2024-2025**

### **Phase 2: Platform Expansion** ✅ Mostly Complete
- [x] **Premium Web Platform**: Cloud sync, stats dashboard, global leaderboard (LIVE!)
- [x] **Mode Systems**: `aws-mode`, `docker-mode`, `k8s-mode` for focused workflows
- [x] **Command Database**: Expanded to 459+ commands (targeting 1000+)
- [x] **Performance**: 1.4-2.0ms (exceeded target of <50ms!) ⚡
- [x] **Testing**: 116/116 tests passing on Ubuntu 22.04/24.04 ✅
- [ ] **Windows PowerShell**: Full Windows environment support

### **Phase 3: Ecosystem Growth**
- [ ] **VS Code Extension**: Integrated terminal support
- [ ] **Team Features**: Shared command libraries and custom definitions
- [ ] **Community Platform**: User-contributed command database
- [ ] **Enterprise Features**: RBAC, audit trails, compliance reporting

### **Phase 4: AI Integration**
- [ ] **Advanced ML**: Context-aware safety assessment
- [ ] **Learning Analytics**: Personalized command recommendations
- [ ] **Intelligent Completion**: Predictive command finishing
- [ ] **Natural Language**: Enhanced conversational interface

## 📈 **Success Metrics**

Terminal Tutor has achieved **production excellence** across all key metrics:

- ✅ **Performance**: 1.4-2.0ms prediction time (96% faster than target!)
- ✅ **Testing**: 116/116 tests passing (100% success rate)
- ✅ **Accuracy**: 100% precision on critical test cases
- ✅ **Coverage**: 459+ commands across major developer tools
- ✅ **Reliability**: Zero-downtime shell integration
- ✅ **User Experience**: Silent operation with action-first UX

## 🏆 **Awards & Recognition**

- **🥇 World's First**: Real-time command education tool
- **⚡ Performance Leader**: 1.4-2.0ms prediction times (96% faster than target)
- **✅ Quality Assurance**: 116/116 tests passing (100% success rate)
- **🧠 Algorithm Innovation**: FZF-inspired exponential position decay
- **🛡️ Safety Pioneer**: Context-aware risk assessment
- **👥 Developer Choice**: Zero-configuration, maximum value

## 🔒 **Security & Privacy**

- **Local Processing**: Commands never leave your machine
- **No Telemetry**: Your workflow stays private
- **Safe Execution**: Commands run only with your explicit approval
- **Code Transparency**: Source code available for review

## 📄 **License**

**Proprietary License** - Personal, non-commercial use permitted. Enterprise/commercial use requires paid license.

For commercial licensing: jatin@terminaltutor.dev

---

## 🚀 **Ready to Transform Your Terminal Experience?**

```bash
# Requirements: Zsh shell + macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install terminal-tutor
terminal-tutor install
exec zsh
# Welcome to the future of command-line learning! ✨
```

**Made with ❤️ by developers, for developers who refuse to settle for outdated tools.**

---

⭐ **Star us on GitHub** if Terminal Tutor revolutionizes your workflow!
🔄 **Share with your team** - spread the command-line revolution!
💬 **Join our community** - help shape the future of terminal education!

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/jatinmayekar/terminal-tutor",
    "name": "terminal-tutor",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": "terminal, cli, learning, commands, tutorial, zsh, shell, education, real-time",
    "author": "Jatin Mayekar",
    "author_email": "Jatin Mayekar <jatin@terminaltutor.dev>",
    "download_url": "https://files.pythonhosted.org/packages/d0/c0/3afc7716b32fb2f7aeb6b0801826f9e3df9107c60a51fb102a00397da673/terminal_tutor-0.1.2.tar.gz",
    "platform": null,
    "description": "# Terminal Tutor \ud83d\ude80\n\n> \u2696\ufe0f **License Notice**: Terminal Tutor is proprietary software. Personal, non-commercial use permitted. Commercial/enterprise use requires a paid license. Unauthorized distribution or modification may result in legal action including statutory damages up to $150,000 per violation. See [LICENSE](LICENSE) file for full terms.\n\n> **World's first real-time command education tool** - Learn terminal commands as you type with instant descriptions, safety warnings, and intelligent suggestions!\n\n[![Production Ready](https://img.shields.io/badge/Status-Production%20Ready-brightgreen)](https://github.com/jatinmayekar/terminal-tutor)\n[![Tests](https://img.shields.io/badge/Tests-116%2F116%20Passing-brightgreen)](tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md)\n[![Performance](https://img.shields.io/badge/Performance-1.6ms%20avg-blue)](tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md)\n[![Commands](https://img.shields.io/badge/Commands-459+-orange)](https://github.com/jatinmayekar/terminal-tutor)\n[![Shell Support](https://img.shields.io/badge/Shell-Zsh%20Required-purple)](https://github.com/jatinmayekar/terminal-tutor)\n[![License](https://img.shields.io/badge/License-Proprietary-red)](LICENSE)\n\n## \ud83c\udfaf What Makes Terminal Tutor Revolutionary?\n\nTerminal Tutor is the **first and only** terminal education tool that provides **real-time command descriptions** as you type - literally keystroke by keystroke. No more waiting, no more guessing, no more dangerous mistakes.\n\n### \u26a1 **Real-Time Magic in Action**\n\n```bash\n# As you type \"git st\" - predictions appear instantly:\n$ git st\u2588                           # \u2190 You're typing here\n\ud83d\udfe2 SAFE - Show working tree status   # \u2190 Live prediction appears below\n```\n\n**Performance**: 1.4-2.0ms response time (96% faster than target!) \u26a1\n\n## \u26a0\ufe0f **Requirements** - Install Zsh First!\n\n**REQUIRED:**\n- \u2705 **Zsh shell** - Real-time predictions ONLY work in Zsh (Bash/Fish not supported yet)\n- \u2705 **Python 3.7+** - Python runtime required\n- \u2705 **macOS/Linux** - Native Unix support\n- \u2705 **Windows** - Via Git Bash or WSL2 (native PowerShell coming 2026)\n\n### **Step 1: Check if you have Zsh installed**\n\n```bash\n# Check if Zsh is installed:\nwhich zsh\n\n# \u2705 If it shows: /bin/zsh or /usr/bin/zsh \u2192 Zsh is installed! Go to Step 2\n# \u274c If it shows: nothing or \"zsh not found\" \u2192 Install Zsh in Step 2\n```\n\n### **Step 2: Install Zsh (if needed)**\n\n```bash\n# macOS (Zsh pre-installed on macOS 10.15+)\n# Skip to Step 3!\n\n# Ubuntu/Debian/Linux Mint\nsudo apt update && sudo apt install zsh\n\n# Fedora/RHEL/CentOS\nsudo dnf install zsh\n\n# Arch Linux\nsudo pacman -S zsh\n```\n\n### **Step 3: Switch to Zsh**\n\n**Option A: Try Zsh NOW (temporary - recommended for testing)**\n```bash\nzsh\n# \u2191 You're now in Zsh! Perfect for testing Terminal Tutor.\n# To exit Zsh and return to your previous shell, type: exit\n```\n\n**Option B: Make Zsh your DEFAULT shell (permanent)**\n```bash\nchsh -s $(which zsh)\n# \u26a0\ufe0f Will ask for your password (your macOS/Linux login password - this is normal!)\n# \u2139\ufe0f If you see \"no changes made\" \u2192 You're already on Zsh! Success!\n# Close terminal and reopen \u2192 You'll be in Zsh automatically\n\n# Verify it worked:\necho $SHELL  # Should show: /bin/zsh\n```\n\n**\ud83d\udca1 Recommended:** Try Option A first to test Terminal Tutor, then use Option B to make it permanent if you like it!\n\n## \ud83d\ude80 **Quick Start** (2 minutes to awesome)\n\n**Step 1: Install with uv (recommended)**\n```bash\n# Install uv if you don't have it\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Install Terminal Tutor with uv\nuv tool install terminal-tutor\n```\n\n**Alternative: Install with pipx**\n```bash\n# If you prefer pipx\npipx install terminal-tutor\n```\n\n**Step 2: Activate real-time predictions**\n```bash\n# Activate the magic (adds to ~/.zshrc)\nterminal-tutor install\n\n# Restart Zsh to load integration\nexec zsh\n```\n\n**Step 3: Test it works!**\n```bash\n# Start typing slowly... watch predictions appear!\ngit st\u2588\n# You should see: \ud83d\udfe2 SAFE - Show working tree status\n\n# Verify installation\nterminal-tutor status\n# Should show: \ud83d\udfe2 Enabled\n```\n\n**You're now a command-line wizard! \u2728**\n\n## \ud83c\udf1f **Core Features**\n\n### \ud83d\udd2e **Real-Time Predictions** (Zsh - World First!)\n- **Keystroke-by-keystroke** command education\n- **1.4-2.0ms** lightning-fast response time (avg 1.6ms)\n- **Live descriptions** appear as you type\n- **Zero latency** user experience\n\n### \ud83e\udde0 **Intelligent Fuzzy Matching**\n- **State-of-the-art algorithm** with exponential position decay\n- **Surgical precision** - no irrelevant suggestions\n- **Context-aware** recommendations\n- **FZF-inspired** smart scoring\n\n```bash\n# Smart suggestions for partial input (use debug for performance metrics)\n$ terminal-tutor debug \"git s\"\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ud83d\udfe2 SAFE git status - Show the working tree status\n\ud83d\udfe1 CAUTION git stash - Stash changes in a dirty working directory\n\ud83d\udfe2 SAFE git show - Show various types of objects\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\u23f1\ufe0f  1.2ms | \ud83d\udcca 3 matches | \ud83d\udd0d fuzzy\n```\n\n### \ud83d\udde3\ufe0f **Natural Language Command Discovery**\n```bash\n# Ask in plain English, get exact commands\n$ terminal-tutor ask \"how to list files\"\nls - \ud83d\udfe2 SAFE - List directory contents\n\n$ terminal-tutor ask \"copy files recursively\"\ncp -r - \ud83d\udfe2 SAFE - Copy directories recursively\n```\n\n**First-time setup**: The ask mode requires an OpenAI API key. On first use, you'll be prompted to enter your key. Get one here: https://platform.openai.com/api-keys\n\n```bash\n# Configure API key manually\n$ terminal-tutor config api-key set\n\n# Check API key status\n$ terminal-tutor config api-key status\n\n# Remove stored API key\n$ terminal-tutor config api-key clear\n```\n\n**Security**: API keys are stored in `~/.terminal_tutor_openai_key` with 600 permissions (user read/write only) and never echoed to the terminal.\n\n### \ud83d\udee1\ufe0f **Advanced Safety System**\n- **\ud83d\udfe2 SAFE** / **\ud83d\udfe1 CAUTION** / **\ud83d\udd34 DANGEROUS** risk levels\n- **Smart pattern recognition** for destructive commands\n- **Context-aware warnings** with safety prompts\n- **False positive elimination** through machine learning\n\n### \ud83d\udcda **Comprehensive Command Database** (459+ commands)\n- **Git**: Complete workflow coverage (13 commands)\n- **Docker**: Container lifecycle management (15 commands)\n- **Kubernetes**: Cluster operations (13 commands)\n- **AWS CLI**: Full cloud platform coverage (96 commands)\n- **System Commands**: Unix/Linux essentials (41+ commands)\n- **Network Tools**: Connectivity and security (45+ commands)\n\n## \ud83c\udfad **Shell Support**\n\n### **Zsh** - Real-Time Predictions (REQUIRED for now)\n```bash\n# \u2705 FULLY SUPPORTED: Real-time predictions with ZLE widgets\n# Type naturally, see descriptions instantly (1.4-2.0ms)\n# Zero configuration after installation\n# This is the ONLY way to experience real-time Terminal Tutor\n```\n\n### **Bash & Fish** - Coming Soon\n```bash\n# \u23f3 PLANNED: Real-time support in future releases\n# Currently, use Zsh for the full experience\n# Bash/Fish users: Install Zsh to use Terminal Tutor\n```\n\n## \ud83c\udfae **Usage Examples**\n\n### **Daily Development Workflow**\n```bash\n# Git operations with confidence\n$ git rebase -i HEAD~3\u2588\n\ud83d\udfe1 CAUTION - Interactively rebase commits (can rewrite history)\n\n# Docker deployments made safe\n$ docker rm -f $(docker ps -aq)\u2588\n\ud83d\udd34 DANGEROUS - Force remove ALL containers (data loss risk)\n\n# Kubernetes with clarity\n$ kubectl delete deployment nginx\u2588\n\ud83d\udfe1 CAUTION - Delete deployment (will terminate all pods)\n```\n\n### **Learning New Tools**\n```bash\n# Explore AWS services with debug (shows performance metrics)\n$ terminal-tutor debug \"aws s3\"\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ud83d\udfe2 SAFE aws s3 ls - List S3 buckets or objects\n\ud83d\udfe2 SAFE aws s3 cp - Copy files to/from S3\n\ud83d\udfe1 CAUTION aws s3 sync - Sync directories with S3\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\u23f1\ufe0f  1.1ms | \ud83d\udcca 3 matches | \ud83c\udfaf exact (+ related)\n\n# Discover system commands\n$ terminal-tutor ask \"monitor system resources\"\nhtop - \ud83d\udfe2 SAFE - Interactive process viewer\n```\n\n## \u2699\ufe0f **Advanced Management**\n\n### **Debug Command** (New - Unified Diagnostic Tool)\n```bash\n# Debug with performance metrics - shows timing, match count, and match type\nterminal-tutor debug \"git\"           # Top 3 matches + performance stats\nterminal-tutor debug \"git status\"    # Exact match + timing\nterminal-tutor debug \"c\"             # Fuzzy matching + metrics\n\n# Example output:\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ud83d\udfe2 SAFE git - Distributed version control system\n\ud83d\udfe2 SAFE git add - Add file contents to the index\n\ud83d\udfe2 SAFE git log - Show commit logs\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\u23f1\ufe0f  1.2ms | \ud83d\udcca 3 matches | \ud83c\udfaf exact (+ related)\n```\n\n**Note**: `explain` and `suggest` commands are deprecated - use `debug` instead.\n\n### **Control Commands**\n```bash\n# Instant control\nterminal-tutor disable   # Pause predictions\nterminal-tutor enable    # Resume magic\nterminal-tutor toggle    # Smart toggle\nterminal-tutor status    # Check state\n\n# Usage insights\nterminal-tutor usage     # View daily stats\nterminal-tutor premium   # Upgrade options\n\n# Configuration\nterminal-tutor config api-key set      # Configure OpenAI API key\nterminal-tutor config api-key status   # Check API key status\nterminal-tutor config api-key clear    # Remove stored API key\n```\n\n### **Custom Commands**\n```bash\n# Add your own commands to Terminal Tutor\n# Create ~/.terminal_tutor_custom_commands.json\n\n{\n  \"version\": \"1.0\",\n  \"commands\": {\n    \"deploy-prod\": {\n      \"description\": \"Deploy to production environment\",\n      \"risk_level\": \"DANGEROUS\",\n      \"category\": \"custom\"\n    },\n    \"my-build\": {\n      \"description\": \"Custom build script for my project\",\n      \"risk_level\": \"SAFE\",\n      \"category\": \"custom\"\n    }\n  }\n}\n\n# Your custom commands will:\n# - Override default commands (if same name)\n# - Appear in fuzzy search results\n# - Work with real-time predictions\n# - Show correct risk levels\n\n# Edit default commands database:\n# terminal_tutor/data/commands.json (459+ commands)\n```\n\n## \ud83d\udc8e **Premium Features**\n\n### **Free Tier** - Forever Free\n- **Unlimited real-time predictions** in Zsh\n- Complete command database (459+ commands, growing to 1000+)\n- All safety warnings and command descriptions\n- BYO API key for ask mode (use your own OpenAI key)\n- Local LLM support (Ollama integration)\n- 7-day local stats history\n\n### **Premium Tier** - $7/month \u2728 **NOW AVAILABLE**\n- **Zero-setup AI** - No API key configuration needed\n- **Cloud-synced stats** - Access from any device with MongoDB Atlas\n- **Developer leaderboard** - See how you rank globally among developers\n- **Stats dashboard** - Track command usage, learning streaks, favorite commands\n- **Team libraries** - Shared command definitions\n- **Priority support** - Direct developer access\n- **Career stats export** - LinkedIn/resume-ready metrics\n\n**\ud83c\udf10 Preview the Premium Dashboard**: Visit [terminaltutor.dev/dashboard-preview](https://terminaltutor.dev/dashboard-preview) to see what Premium offers!\n\n### **Web Platform Architecture**\nThe Premium tier is powered by a production-ready web platform:\n- **Frontend/Backend**: Next.js 15 with App Router (deployed on Vercel)\n- **Database**: MongoDB Atlas (cloud-synced user stats and command history)\n- **Authentication**: NextAuth v5 with Google OAuth\n- **API Routes**: RESTful endpoints for stats sync and leaderboard\n- **Dashboard Components**: Real-time stats visualization with DaisyUI\n\nFor deployment documentation, see [`docs/deployment/DEPLOYMENT_GUIDE.md`](docs/deployment/DEPLOYMENT_GUIDE.md)\n\n## \ud83e\uddea **Technical Excellence**\n\n### **Performance Benchmarks**\n- **Prediction Time**: 1.4-2.0ms avg (target: <50ms) \u2705 **96% faster!**\n- **Test Results**: 116/116 tests passing across Ubuntu 22.04/24.04 \u2705\n- **Algorithm Precision**: 100% on critical test cases \u2705\n- **Memory Usage**: Minimal footprint with intelligent caching\n- **Startup Time**: Zero-latency shell integration\n\n### **Architecture Highlights**\n- **O(1) prefix tree lookup** for instant command matching\n- **Exponential position decay** for fuzzy search precision\n- **File-based controls** for real-time performance\n- **Graceful degradation** when offline or under load\n\n### **Quality Standards**\n- **Security First**: No credential exposure, safe execution\n- **Backward Compatibility**: Seamless upgrades\n- **Shell Agnostic**: Works across Unix/Linux environments\n- **Silent Operation**: No noise, action-first UX\n\n### **Platform Compatibility**\n\n| Platform | Status | Tests | Performance | Notes |\n|----------|--------|-------|-------------|-------|\n| Ubuntu 22.04 (Zsh) | \u2705 Verified | 29/29 | 1.7-1.8ms | 100% pass rate |\n| Ubuntu 22.04 + Oh-My-Zsh | \u2705 Verified | 29/29 | 1.7ms | Full compatibility |\n| Ubuntu 24.04 (Zsh) | \u2705 Verified | 29/29 | 1.4ms | \u26a1 Fastest |\n| Ubuntu 24.04 + Oh-My-Zsh | \u2705 Verified | 29/29 | 1.5ms | Full compatibility |\n| macOS (Zsh) | \u2705 Working | - | 2.0ms | Core functionality verified |\n| WSL2 (Ubuntu) | \ud83d\udfe1 Expected | - | - | Should work (Ubuntu compat) |\n| PowerShell | \ud83d\udea7 Planned | - | - | Coming 2026 |\n\n**Total Tests**: 116/116 passing (100% success rate)\n\n**Documentation**: See [tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md](tests/results/linux/UBUNTU_FINAL_SUCCESS_V3.md) for detailed test reports.\n\n## \ud83d\udee0\ufe0f **Installation & Setup**\n\n### **System Requirements**\n- \u2705 **Zsh shell** - REQUIRED (Bash/Fish not supported yet)\n- \u2705 **Python 3.7-3.13** - Runtime environment\n- \u2705 **macOS/Linux** - Native Unix support\n- \u2705 **Windows** - Via Git Bash or WSL2 (native PowerShell coming 2026)\n- \u2705 **uv or pipx** - Recommended installation tool\n\n### **Production Installation (Recommended)**\n```bash\n# Method 1: Using uv (fastest, recommended)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nuv tool install terminal-tutor\nterminal-tutor install\nexec zsh\n\n# Method 2: Using pipx\npipx install terminal-tutor\nterminal-tutor install\nexec zsh\n\n# Verify it works\nterminal-tutor status  # Should show: \ud83d\udfe2 Enabled\n```\n\n### **Development Installation**\n```bash\n# Clone repository\ngit clone https://github.com/jatinmayekar/terminal-tutor.git\ncd terminal-tutor\n\n# Install in editable mode\nuv tool install --editable .\n# OR: pipx install --editable .\n\n# Activate\nterminal-tutor install\nexec zsh\n\n# Test with debug mode\nterminal-tutor debug \"git\"  # Shows performance metrics\n```\n\n### **Troubleshooting**\n\n#### **\"command not found: terminal-tutor\" after pip install**\n\nIf you installed with `pip install terminal-tutor` (instead of `uv` or `pipx`) and see this error, the installation directory may not be in your PATH.\n\n**Quick Fix:**\n```bash\n# Add ~/.local/bin to PATH temporarily\nexport PATH=\"$HOME/.local/bin:$PATH\"\n\n# Test it works now\nterminal-tutor status\n\n# Make it permanent by adding to ~/.zshrc\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n**Better Solution** - Use `uv` or `pipx` (handles PATH automatically):\n```bash\n# Uninstall pip version\npip uninstall terminal-tutor\n\n# Reinstall with uv (recommended)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nuv tool install terminal-tutor\n```\n\n**Why this happens**: When using `pip install --user`, Python installs to `~/.local/bin`, which may not be in your default PATH on some systems.\n\n---\n\n#### **Real-time predictions not working after install**\n\nIf `terminal-tutor install` succeeds but real-time predictions don't appear when typing:\n\n**Check if integration loaded:**\n```bash\n# Should show tt_predict_realtime and other widgets\nzle -la | grep tt_\n```\n\n**If empty, manually reload:**\n```bash\n# Find the integration file\nfind /usr -name \"zsh_integration.zsh\" 2>/dev/null\n\n# Source it (use the path from above)\nsource /usr/local/lib/python3.12/dist-packages/terminal_tutor/zsh_integration.zsh\n\n# Or reinstall\nterminal-tutor install\nexec zsh\n```\n\n**Why this happens**: In some environments (Docker, fresh installs), the shell config file may not exist or the SHELL environment variable may not be set correctly. The latest version creates the file automatically.\n\n## \ud83c\udf0d **Community & Contribution**\n\n### **Join the Revolution**\n- \ud83c\udf1f **Star us** on GitHub to support development\n- \ud83d\udc1b **Report issues** to help us improve\n- \ud83d\udca1 **Suggest features** for future releases\n- \ud83d\udcda **Contribute commands** to expand the database\n\n### **Developer Resources**\n- **Documentation**: Complete agent onboarding in `CLAUDE.md`\n- **Strategy Docs**: Business strategy and ICP analysis in `docs/strategy/`\n- **Deployment Guides**: Production deployment in `docs/deployment/`\n- **Research**: Algorithm analysis in `docs/research/`\n- **Launch Content**: Marketing content and launch plan in `docs/launch/`\n- **Testing**: Beta testing strategy in `evaluation/` folder\n- **Roadmap**: Future plans in `TODO.md`\n\n## \ud83d\uddfa\ufe0f **Roadmap 2024-2025**\n\n### **Phase 2: Platform Expansion** \u2705 Mostly Complete\n- [x] **Premium Web Platform**: Cloud sync, stats dashboard, global leaderboard (LIVE!)\n- [x] **Mode Systems**: `aws-mode`, `docker-mode`, `k8s-mode` for focused workflows\n- [x] **Command Database**: Expanded to 459+ commands (targeting 1000+)\n- [x] **Performance**: 1.4-2.0ms (exceeded target of <50ms!) \u26a1\n- [x] **Testing**: 116/116 tests passing on Ubuntu 22.04/24.04 \u2705\n- [ ] **Windows PowerShell**: Full Windows environment support\n\n### **Phase 3: Ecosystem Growth**\n- [ ] **VS Code Extension**: Integrated terminal support\n- [ ] **Team Features**: Shared command libraries and custom definitions\n- [ ] **Community Platform**: User-contributed command database\n- [ ] **Enterprise Features**: RBAC, audit trails, compliance reporting\n\n### **Phase 4: AI Integration**\n- [ ] **Advanced ML**: Context-aware safety assessment\n- [ ] **Learning Analytics**: Personalized command recommendations\n- [ ] **Intelligent Completion**: Predictive command finishing\n- [ ] **Natural Language**: Enhanced conversational interface\n\n## \ud83d\udcc8 **Success Metrics**\n\nTerminal Tutor has achieved **production excellence** across all key metrics:\n\n- \u2705 **Performance**: 1.4-2.0ms prediction time (96% faster than target!)\n- \u2705 **Testing**: 116/116 tests passing (100% success rate)\n- \u2705 **Accuracy**: 100% precision on critical test cases\n- \u2705 **Coverage**: 459+ commands across major developer tools\n- \u2705 **Reliability**: Zero-downtime shell integration\n- \u2705 **User Experience**: Silent operation with action-first UX\n\n## \ud83c\udfc6 **Awards & Recognition**\n\n- **\ud83e\udd47 World's First**: Real-time command education tool\n- **\u26a1 Performance Leader**: 1.4-2.0ms prediction times (96% faster than target)\n- **\u2705 Quality Assurance**: 116/116 tests passing (100% success rate)\n- **\ud83e\udde0 Algorithm Innovation**: FZF-inspired exponential position decay\n- **\ud83d\udee1\ufe0f Safety Pioneer**: Context-aware risk assessment\n- **\ud83d\udc65 Developer Choice**: Zero-configuration, maximum value\n\n## \ud83d\udd12 **Security & Privacy**\n\n- **Local Processing**: Commands never leave your machine\n- **No Telemetry**: Your workflow stays private\n- **Safe Execution**: Commands run only with your explicit approval\n- **Code Transparency**: Source code available for review\n\n## \ud83d\udcc4 **License**\n\n**Proprietary License** - Personal, non-commercial use permitted. Enterprise/commercial use requires paid license.\n\nFor commercial licensing: jatin@terminaltutor.dev\n\n---\n\n## \ud83d\ude80 **Ready to Transform Your Terminal Experience?**\n\n```bash\n# Requirements: Zsh shell + macOS/Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\nuv tool install terminal-tutor\nterminal-tutor install\nexec zsh\n# Welcome to the future of command-line learning! \u2728\n```\n\n**Made with \u2764\ufe0f by developers, for developers who refuse to settle for outdated tools.**\n\n---\n\n\u2b50 **Star us on GitHub** if Terminal Tutor revolutionizes your workflow!\n\ud83d\udd04 **Share with your team** - spread the command-line revolution!\n\ud83d\udcac **Join our community** - help shape the future of terminal education!\n",
    "bugtrack_url": null,
    "license": "Proprietary",
    "summary": "Real-time terminal command education for Zsh - 1.6ms avg predictions, 459+ commands, 100% tested (Zsh required)",
    "version": "0.1.2",
    "project_urls": {
        "Homepage": "https://github.com/jatinmayekar/terminal-tutor"
    },
    "split_keywords": [
        "terminal",
        " cli",
        " learning",
        " commands",
        " tutorial",
        " zsh",
        " shell",
        " education",
        " real-time"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ef248c3882cd9349d1c5fd71799abc8bca575316a0d43de23602f6afbda9b9c8",
                "md5": "f41d8f73ec41db32addfa69fb2f83af0",
                "sha256": "e8ded0d691a36bc9a313af5f749959406272cd443ca6075040dd8f485f03b590"
            },
            "downloads": -1,
            "filename": "terminal_tutor-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f41d8f73ec41db32addfa69fb2f83af0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 44446,
            "upload_time": "2025-10-27T03:41:27",
            "upload_time_iso_8601": "2025-10-27T03:41:27.481897Z",
            "url": "https://files.pythonhosted.org/packages/ef/24/8c3882cd9349d1c5fd71799abc8bca575316a0d43de23602f6afbda9b9c8/terminal_tutor-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d0c03afc7716b32fb2f7aeb6b0801826f9e3df9107c60a51fb102a00397da673",
                "md5": "d09cff314d5a0c78114bb6c5c59614a0",
                "sha256": "30f17a76be32d0c76ac6a9f7f2652b969fe1549e66574f3d1cb42d1e6a85e745"
            },
            "downloads": -1,
            "filename": "terminal_tutor-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "d09cff314d5a0c78114bb6c5c59614a0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 50899,
            "upload_time": "2025-10-27T03:41:28",
            "upload_time_iso_8601": "2025-10-27T03:41:28.876522Z",
            "url": "https://files.pythonhosted.org/packages/d0/c0/3afc7716b32fb2f7aeb6b0801826f9e3df9107c60a51fb102a00397da673/terminal_tutor-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-27 03:41:28",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jatinmayekar",
    "github_project": "terminal-tutor",
    "github_not_found": true,
    "lcname": "terminal-tutor"
}