Skip to content

kernelcero/bit-python-tutor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐍 Bit: Your Local Python Mentor

License: MIT Python Ollama

Bit is a senior-level AI mentor that runs 100% locally on your machine. Designed for absolute beginners, Bit teaches Python using Silicon Valley best practices and an immersive English-only approach.

🚀 Why Bit?

  • Privacy First: Your code and conversations never leave your computer.
  • Zero Cost: No API keys, no monthly fees. Powered by Ollama.
  • Pro Pedagogy: Line-by-line explanations and real-world analogies.
  • Auto-Exercise: Automatically extracts and saves your coding lessons.

🛠️ Tech Stack

  • Engine: Ollama
  • Model: qwen2.5-coder:7b (optimized for code)
  • OS: Linux Mint / Ubuntu / macOS

⚙️ Installation

1. Install Ollama

Download and install from ollama.com. Then, pull the brain for Bit:

ollama run qwen2.5-coder:7b

### 2. Setup Project
git clone [https://github.com/juanpablolertora/bit-python-tutor.git](https://github.com/juanpablolertora/bit-python-tutor.git)
cd bit-python-tutor
pip install -r requirements.txt

### 3. Usage
Start your session by running:
python3 main.py

## MACHINE

dev@mint-workspace 
          .-MMMMMMMMMMMMMMM-.               -------------- 
      .-MMMM`..-:::::::-..`MMMM-.           OS: Linux Mint 22.3 x86_64 
    .:MMMM.:MMMMMMMMMMMMMMM:.MMMM:.         Host: Lenovo LOQ (AMD/NVIDIA) 
   -MMM-M---MMMMMMMMMMMMMMMMMMM.MMM-        Kernel: 6.14.x-generic 
 `:MMM:MM`  :MMMM:....::-...-MMMM:MMM:`     Uptime: (Confidencial) 
 :MMM:MMM`  :MM:`   ``    ``  `:MMM:MMM:    Packages: 3194 (dpkg) 
.MMM.MMMM`  :MM.  -MM.  .MM-  `MMMM.MMM.    Shell: bash 5.2.x 
:MMM:MMMM`  :MM.  -MM-  .MM:  `MMMM-MMM:    Resolution: 1920x1080 
:MMM:MMMM`  :MM.  -MM-  .MM:  `MMMM:MMM:    DE: Cinnamon 6.6.6 
:MMM:MMMM`  :MM.  -MM-  .MM:  `MMMM-MMM:    WM: Mutter (Muffin) 
.MMM.MMMM`  :MM:--:MM:--:MM:  `MMMM.MMM.    Terminal: gnome-terminal 
 :MMM:MMM-  `-MMMMMMMMMMMM-`  -MMM-MMM:     CPU: AMD Ryzen 7 7000 Series (16) 
  :MMM:MMM:`                `:MMM:MMM:      GPU: NVIDIA GeForce RTX 4060 
   .MMM.MMMM:--------------:MMMM.MMM.       Memory: 24GB RAM 
     '-MMMM.-MMMMMMMMMMMMMMM-.MMMM-'        
       '.-MMMM``--:::::--``MMMM-.'          
           '-MMMMMMMMMMMMM-'

About

"Local AI Python Tutor using Ollama & Qwen2.5-Coder. Features auto-saving exercises and Stanford-style mentorship. Privacy-focused learning."

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages