bourguibagpt 2.0.0

Tunisian Shell Command Assistant

---

BourguibaGPT 🇹🇳

Your AI-Powered Tunisian Shell Command Assistant

Python Version: 3.6+
License: MIT
PyPI Version: Check Here

BourguibaGPT is an intelligent CLI tool that transforms natural language requests into safe shell commands using advanced AI models. Designed with a focus on safety and usability, it's your perfect companion for terminal productivity.

CLI Demo: View Image

---

Features ✨

• Natural Language Understanding 🇹🇳
  Describe tasks in plain English, French, or Arabic (Tunisian dialect friendly!).
• AI-Powered Command Generation 🤖
  Leverages local LLMs via Ollama (default: deepseek-r1:1.5b).
• Safety First 🔒
  Multi-layer validation against dangerous commands.
• Interactive CLI 💻
  Rich terminal interface with syntax highlighting and progress indicators.
• Command History 📚
  Automatic tracking of generated commands with execution status.
• Cross-Platform 🌍
  Supports Linux, macOS, and Windows Subsystem for Linux.
• Smart Execution ⚡
  Optional auto-execution with confirmation prompts.

---

Installation 📦

Step 1: Install Ollama (required)

Run the following command in the terminal:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull deepseek-r1:1.5b

Step 2: Install BourguibaGPT

Now install BourguibaGPT with:

pip install bourguibagpt

---

Quick Start 🚀

Run the command:

bourguibagpt

Example interaction:

╔══════════════════════════════════════════════════════════════╗
║              Your Tunisian Shell Command Assistant           ║
╚══════════════════════════════════════════════════════════════╝

🇹🇳 BourguibaGPT → list all json files modified last week
Generated command: find . -name "*.json" -mtime -7

Execute? [yes/no]: yes
✅ Command executed successfully

---

Advanced Usage 🛠️

Command Line Options

bourguibagpt [OPTIONS]

• --model MODEL_NAME → Specify Ollama model (default: deepseek-r1:1.5b).
• --temperature FLOAT → Control creativity (0.1-1.0, default: 0.7).
• --auto-execute → Auto-execute validated commands.
• --history-file PATH → Custom command history location.

Manage History

Show last 10 commands:
bourguibagpt --history

Execute from history:
bourguibagpt execute "find . -name *.json -mtime -7"

---

Safety Measures ⚠️

BourguibaGPT includes multiple protection layers:

• Pattern matching against dangerous commands (e.g., rm -rf /).
• Command structure validation.
• Execution confirmation prompts.
• Restricted special characters handling.
• Model prompt engineering for safety.

---

Roadmap 🗺️

• Browser-based GUI
• Command explanation mode
• Plugin system for custom validations
• Shared team history sync
• Alternative AI backend support

---

Contributing 🤝

We welcome contributions! Please see our Contribution Guidelines (CONTRIBUTING.md) for details.

---

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

---

GitHub Repository: Visit Here
Report Issues: Submit Here

---