# Abliterated Tool-Use Agent

A Python script that runs an **uncensored, abliterated Qwen3 model** via Ollama with full tool-use capabilities.

## What it does

The model can autonomously:
- **Search the web** (DuckDuckGo, no API key needed)
- **Fetch and read webpages** (extract text from any URL)
- **Run shell commands** on your machine (nmap, curl, scripts, whatever)
- **Read and write files** on disk
- **Make HTTP requests** to any API or endpoint
- Then **synthesize everything into a concise answer** — no rambling

## Quick start — Kali PC

```bash
# 1. Install Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 2. Download the 8B model (smarter, 4.7GB)
ollama pull huihui/qwen3-abliterated:8b

# 3. Install Python deps
pip install requests beautifulsoup4

# 4. Download this script
wget -O abliterated_agent.py https://huggingface.co/Bigbarry/abliterated-agent/resolve/main/abliterated_agent.py

# 5. Run it
python3 abliterated_agent.py
```

## Quick start — Phone (NetHunter / Termux)

```bash
# 1. Install Ollama
pkg install ollama

# 2. Start the server
ollama serve &

# 3. Download the 4B model (smaller, 2.3GB, fits on phone)
ollama pull huihui/qwen3-abliterated:4b-instruct-2507

# 4. Install Python deps
pip install requests beautifulsoup4

# 5. Download this script
wget -O abliterated_agent.py https://huggingface.co/Bigbarry/abliterated-agent/resolve/main/abliterated_agent.py

# 6. Run it with the 4B model
python3 abliterated_agent.py --model huihui/qwen3-abliterated:4b-instruct-2507
```

## Usage

```bash
# Interactive chat (default)
python3 abliterated_agent.py

# Use the smaller 4B model (better for phone)
python3 abliterated_agent.py --model huihui/qwen3-abliterated:4b-instruct-2507

# Disable shell execution (safer mode)
python3 abliterated_agent.py --no-shell

# Run a single prompt (no interactive mode)
python3 abliterated_agent.py --prompt "search the web for latest CVEs and summarize"
```

## Models

| Model | Size | Best for | Ollama tag |
|-------|------|----------|------------|
| Qwen3-4B-Instruct-2507 abliterated | 2.3GB (Q4_K_M) | Phone / NetHunter | `huihui/qwen3-abliterated:4b-instruct-2507` |
| Qwen3-8B abliterated v2 | 4.7GB (Q4_K_M) | Kali PC / laptop | `huihui/qwen3-abliterated:8b` |

The 4B "Instruct-2507" variant is **non-thinking** — it gives direct, concise answers without chain-of-thought rambling.

## Tools available

| Tool | What it does |
|------|-------------|
| `web_search` | Search DuckDuckGo, returns titles/URLs/snippets |
| `fetch_webpage` | Download a URL and extract readable text |
| `http_request` | Make GET/POST/PUT/DELETE requests to any URL |
| `run_shell` | Execute shell commands, returns stdout/stderr/exit code |
| `read_file` | Read any file from disk |
| `write_file` | Write content to a file on disk |

## License

Apache 2.0 (model) / script is free to use.