Jarvis Buddy 🤖

A chill AI assistant that lives in your terminal — controls your computer, reads files, searches the web, all in plain English.

Made by a 15-year-old who wanted his own Jarvis. Now anyone can have one.

---

✨ Features

• 🧠 Remembers you across sessions
• 🖥️ Control your computer with natural language ("take me to Downloads")
• 📄 Read any file including PDFs
• 🌐 Search the web (DuckDuckGo, no API key)
• 📖 Fetch and read webpages (Wikipedia, Reddit, GitHub, articles)
• 🛡️ Safety system with confirmations for risky commands
• 🗑️ Automatic backup before deleting files
• 🎨 Beautiful colored terminal interface

---

💻 Supported Platforms

• ✅ Linux (all distros)
• ✅ macOS
• ❌ Windows — use WSL or switch to Linux 🐧

---

📦 Installation

pip install jarvis-buddy

---

⚙️ Setup

1. Get a free API key from Groq
2. Configure it: jarvis setup
3. Start chatting: jarvis

---

💬 Usage

Just talk to Jarvis like a normal person:

• "take me to my downloads folder"
• "what files are here?"
• "read main.py and explain it to me"
• "search for the latest python news"
• "fetch the wikipedia page for machine learning"
• "make a new folder called projects"

Type quit to exit, reset to wipe memory.

---

💰 Cost

Jarvis uses Groq's API. You have 2 options:

• 🆓 Free tier — 100k tokens/day (~150-200 messages). Enough for casual daily use.
• 💰 Dev tier — deposit ~$5-10, get thousands of messages. Way cheaper than ChatGPT Plus.

Get your key at console.groq.com/keys

---

🛡️ Safety

Jarvis has 3 command tiers:

• 🟢 Safe — read/navigate freely (ls, cd, cat, etc.)
• 🟡 Confirm — asks before modifying anything (rm, mv, pip install)
• 🔴 Banned — never runs (sudo, disk formatting, system files)

Deleted files get backed up to ~/.jarvis/trash/ first, just in case.

---

🔧 Commands

Command	What it does
jarvis	Start chatting
jarvis setup	Configure your API key
jarvis reset	Wipe conversation memory
jarvis --help	Show help

---

📁 Files

Jarvis stores everything in ~/.jarvis/:

• config.env — your API key
• memory.json — conversation history
• action_log.txt — every command that ran
• trash/ — backups of deleted files

---

📜 License

MIT — do whatever you want with it.

---

👤 Author

Made with too much caffeine by Najib

Star the repo ⭐ if you like it!