📦 Installation

Method 1: pip (Recommended)

Install from PyPI:

pip install djinn-cli

Upgrade to Latest

pip install --upgrade djinn-cli

Install Specific Version

pip install djinn-cli==2.0.0    # Latest
pip install djinn-cli==1.0.2    # Previous
pip install djinn-cli==1.0.0    # First release

Install from GitHub

pip install git+https://github.com/boubli/djinn.git

Method 2: Windows Executable

No Python required:

1. Go to GitHub Releases
2. Download djinn.exe
3. Move to a folder in your PATH
4. Run from any terminal

Method 3: From Source

git clone https://github.com/boubli/djinn.git
cd djinn
pip install -e .

Verify Installation

djinn --version
djinn --help

Requirements

• Python: 3.8 or higher
• OS: Windows, macOS, Linux

Dependencies (auto-installed)

• click - CLI framework
• rich - Beautiful terminal output
• requests - HTTP client
• pyperclip - Clipboard support

Optional Dependencies

# For system dashboard
pip install psutil

# For voice control
pip install SpeechRecognition pyaudio

# For PostgreSQL database viewer
pip install psycopg2

# For MySQL database viewer
pip install mysql-connector-python

Quick LLM Setup

After installing, set up an AI backend:

Option A: Ollama (Free & Local)

# Install Ollama from https://ollama.ai
ollama serve
ollama pull llama3.2

# Configure DJINN
djinn config set provider ollama
djinn config set model llama3.2

Option B: OpenAI (Cloud)

export OPENAI_API_KEY="your-key"
djinn config set provider openai
djinn config set model gpt-4

See full LLM setup guide →

Quick Test

# Generate a command
djinn "list all Python files"

# Interactive mode
djinn -i

# Launch dashboard
djinn dashboard

# View help
djinn --help

Troubleshooting

"djinn not found"

Add Python scripts to your PATH:

# Windows
set PATH=%PATH%;%APPDATA%\Python\Python311\Scripts

# Linux/macOS
export PATH=$PATH:~/.local/bin

"No LLM configured"

djinn config set provider ollama
djinn config set model llama3.2

"Permission denied"

# Linux/macOS
sudo pip install djinn-cli

# Or install for user only
pip install --user djinn-cli

Version History