Metadata-Version: 2.4
Name: djinn-cli
Version: 2.3.1
Summary: AI-powered CLI that converts natural language into shell commands. Built-in tools for DevOps, Security, Development, and Productivity.
Author-email: Youssef Boubli <bbb.vloger@gmail.com>
License: MIT
Project-URL: Homepage, https://boubli.tech
Project-URL: Repository, https://github.com/boubli/djinn
Project-URL: Issues, https://github.com/boubli/djinn/issues
Keywords: cli,terminal,ai,llm,shell,commands,ollama,devops,automation
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Requires-Dist: requests>=2.28
Requires-Dist: openai>=1.0
Requires-Dist: pyperclip>=1.8
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: psutil>=5.9
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Provides-Extra: full
Requires-Dist: textual>=0.40; extra == "full"
Requires-Dist: cryptography>=41.0; extra == "full"
Requires-Dist: pip-audit>=2.6; extra == "full"
Requires-Dist: qrcode>=7.4; extra == "full"
Requires-Dist: pillow>=10.0; extra == "full"
Requires-Dist: tqdm>=4.66; extra == "full"
Requires-Dist: PyPDF2>=3.0; extra == "full"
Requires-Dist: pyfiglet>=0.8; extra == "full"
Requires-Dist: dnspython>=2.4; extra == "full"
Requires-Dist: speedtest-cli>=2.1; extra == "full"
Requires-Dist: beautifulsoup4>=4.12; extra == "full"
Requires-Dist: schedule>=1.2; extra == "full"
Requires-Dist: spotipy>=2.23; extra == "full"
Requires-Dist: SpeechRecognition>=3.10; extra == "full"
Requires-Dist: pyttsx3>=2.90; extra == "full"
Provides-Extra: tui
Requires-Dist: textual>=0.40; extra == "tui"
Requires-Dist: pyfiglet>=0.8; extra == "tui"
Provides-Extra: security
Requires-Dist: cryptography>=41.0; extra == "security"
Requires-Dist: pip-audit>=2.6; extra == "security"
Provides-Extra: network
Requires-Dist: dnspython>=2.4; extra == "network"
Requires-Dist: speedtest-cli>=2.1; extra == "network"
Requires-Dist: beautifulsoup4>=4.12; extra == "network"
Provides-Extra: files
Requires-Dist: qrcode>=7.4; extra == "files"
Requires-Dist: pillow>=10.0; extra == "files"
Requires-Dist: tqdm>=4.66; extra == "files"
Requires-Dist: PyPDF2>=3.0; extra == "files"
Provides-Extra: voice
Requires-Dist: SpeechRecognition>=3.10; extra == "voice"
Requires-Dist: pyttsx3>=2.90; extra == "voice"
Provides-Extra: music
Requires-Dist: spotipy>=2.23; extra == "music"
Dynamic: license-file

<div align="center">

<img src="assets/djinn_logo.png" width="200" alt="DJINN Logo">

<br>

[![PyPI Version](https://img.shields.io/pypi/v/djinn-cli.svg?color=green&label=version)](https://pypi.org/project/djinn-cli/)
[![Python Versions](https://img.shields.io/badge/python-3.8+-blue.svg)](https://pypi.org/project/djinn-cli/)
[![License](https://img.shields.io/badge/license-MIT-purple.svg)](LICENSE)
[![Commands](https://img.shields.io/badge/commands-60%2B-orange.svg)](https://github.com/boubli/djinn)
[![Plugins](https://img.shields.io/badge/plugins-900%2B-red.svg)](https://github.com/boubli/djinn)

# ⚡ DJINN

### The Ultimate AI-Powered CLI Tool

Transform natural language into precise shell commands with 60+ built-in commands and 900+ plugin templates.
<br>
TUI Dashboard • Universal Package Manager • Voice Control • AI Code Reviewer

</div>

<br>

```bash
djinn "find all files larger than 100MB and sort by size"
```

---

## ⚡ Key Features

- **Natural Language Parsing**: Uses LLMs (Ollama, OpenAI, LM Studio) to understand you.
- **Smart Execution**: `djinn -x` to run commands instantly.
- **Interactive Mode**: `djinn -i` for a chat-like experience.
- **180+ Built-in Commands**: Git, Docker, Network, Files, Security, and more.
- **Plugin Marketplace**: Download 30+ additional plugins.
- **Cross-Platform**: Windows, macOS, Linux.

---

## 🔌 Plugins System

### Built-in Plugins (Included)

DJINN comes with **100+ commands built-in**, covering:

| Category     | Commands                                        |
| ------------ | ----------------------------------------------- |
| **Git**      | `djinn git status`, `djinn git undo`            |
| **Docker**   | `djinn docker cleanup`, `djinn docker logs`     |
| **Network**  | `djinn ip`, `djinn ports`, `djinn ping`         |
| **Files**    | `djinn tree`, `djinn search`, `djinn qr`        |
| **Security** | `djinn pass`, `djinn audit`, `djinn hash`       |
| **System**   | `djinn sysinfo`, `djinn monitor`, `djinn clean` |

### 🛒 Plugin Marketplace (Download More)

Want more features? Install additional plugins from the marketplace:

```bash
# Browse available plugins
djinn market list

# Install a plugin
djinn market install spotify
djinn market install notion-cli
djinn market install kubernetes

# View installed plugins
djinn plugins installed

# Remove a plugin
djinn plugins remove spotify
```

### 📦 30+ Marketplace Plugins Available

| Category         | Plugins                                                                                   |
| ---------------- | ----------------------------------------------------------------------------------------- |
| **AI & ML**      | `ollama-manager`, `openai-chat`, `huggingface`                                            |
| **Cloud**        | `vercel-deploy`, `firebase`, `netlify`, `aws-toolkit`, `cloudflare`, `supabase`, `stripe` |
| **DevOps**       | `kubernetes`, `terraform`, `system-monitor`                                               |
| **Databases**    | `database-cli`, `redis-cli`, `elasticsearch`                                              |
| **Development**  | `api-tester`, `github-toolkit`, `webhook-tester`, `data-converter`, `data-faker`          |
| **Productivity** | `notion-cli`, `slack-cli`, `todoist`, `linear`, `jira`, `pomodoro`, `screenshot`          |
| **Security**     | `password-manager` (1Password/Bitwarden)                                                  |
| **Media**        | `spotify`, `youtube-dl`                                                                   |

See all plugins: [marketplace/README.md](marketplace/README.md)

---

## 📚 Documentation

Everything you need to know about using DJINN:

- **[Installation Guide](docs/installation.md)**: Install via Pip, Script, Homebrew, or Docker.
- **[Command Reference](docs/commands.md)**: Master the CLI, from aliases to configuration.
- **[Plugins & Subcommands](docs/plugins.md)**: Learn about the plugin system.
- **[Marketplace](marketplace/README.md)**: Browse and create plugins.

---

## 🚀 Quick Start

```bash
# Install DJINN
pip install djinn-cli

# Run setup wizard (first time)
djinn setup

# Use natural language
djinn "list all docker containers"

# Or use direct commands
djinn git status
djinn docker cleanup
djinn sysinfo

# Install more plugins
djinn market install spotify
djinn spotify now
```

---

## 🤝 Contributing

We love contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

### Creating Plugins

Want to create your own plugin?

```bash
# Generate plugin template
djinn plugins create my-awesome-plugin
```

See [marketplace/README.md](marketplace/README.md) for plugin development guide.

---

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
