| # 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. |
|
|
