README.md

---
title: ShellWhisperer-1.5B
emoji: 🐚
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: apache-2.0
---

# ShellWhisperer-1.5B

A fast, lightweight shell and CLI specialist model. Optimized for generating production-ready terminal code — bash scripts, Python automation, Docker commands, git workflows, and API calls.

## TL;DR

**1 GB · 29 tok/s · Free to use · Raw Ollama API**

Focused prompts → working code. Not explanations. Not plans. The actual script, ready to save and run.

## Capabilities

### ✅ What It Can Do
- Write complete bash scripts with functions, error handling, and logging
- Generate Python automation and data processing scripts
- Create Dockerfiles, compose files, and container commands
- Build git workflows and version control operations
- Construct API calls and curl commands
- Handle system administration and file management tasks

### ❌ What It Cannot Do
- Frontend development (HTML, CSS, JavaScript)
- Large file processing or full codebase rewrites
- The context window is limited — prompts should target single functions or focused tasks

## Usage

The Space exposes a raw Ollama API at `/api/chat`:

```bash
curl -X POST https://karma-devops-shellwhisperer-demo.hf.space/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "model": "FableForge-AI/shellwhisperer",
    "messages": [{"role": "user", "content": "Write a bash script to monitor a directory for new files"}],
    "stream": false
  }'
```

## Best Practices

| Do | Don't |
|----|-------|
| Send focused, single-function prompts | Send entire files or codebases |
| Ask for specific outputs (bash, Python, Docker) | Ask for frontend or UI code |
| Review generated code before running | Assume output is production-ready without review |

## Credits

Built by **FableForge AI** as part of the Mythos model ecosystem.

- **Original Repo:** [github.com/KingLabsA/mythos](https://github.com/KingLabsA/mythos)
- **HuggingFace:** [huggingface.co/fableforge-ai](https://huggingface.co/fableforge-ai)
- **License:** Apache 2.0

*ShellWhisperer-1.5B is a fine-tuned shell specialist based on Qwen2.5-1.5B, part of the FableForge open-source agent ecosystem.*