https://github.com/shadowquillapp/shadowquillapp
ShadowQuill is a privacy‑first, offline and free prompt engineering/generation app powered by self-hosted local LLMs (ollama+gemma3)
https://github.com/shadowquillapp/shadowquillapp
gemma3 llms local-ai localization offline-first ollama privacy-first prompt-engineering self-hosted
Last synced: 12 days ago
JSON representation
ShadowQuill is a privacy‑first, offline and free prompt engineering/generation app powered by self-hosted local LLMs (ollama+gemma3)
- Host: GitHub
- URL: https://github.com/shadowquillapp/shadowquillapp
- Owner: shadowquillapp
- License: mit
- Created: 2025-08-09T14:19:26.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2026-03-03T15:00:43.000Z (19 days ago)
- Last Synced: 2026-03-03T19:36:01.356Z (19 days ago)
- Topics: gemma3, llms, local-ai, localization, offline-first, ollama, privacy-first, prompt-engineering, self-hosted
- Language: TypeScript
- Homepage: https://shadowquill.org
- Size: 5.75 MB
- Stars: 20
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ShadowQuill v0.9.4
**Privacy-First AI Prompt Studio**
[](https://shadowquill.org)
[](https://github.com/shadowquillapp/shadowquillapp/stargazers)
[](LICENSE)
## Overview
ShadowQuill transforms natural language ideas into structured, high-quality prompts. Powered by Ollama and Gemma 3, it runs 100% offline, completely local and free.
## Quick Start
**Prerequisites:** [Ollama](https://ollama.com) with a Gemma 3 model
```bash
# Download a model (choose based on your RAM)
ollama pull gemma3:4b # 8GB+ RAM
ollama pull gemma3:12b # 16GB+ RAM
ollama pull gemma3:27b # 32GB+ RAM + GPU
# Clone, install, and run
git clone https://github.com/shadowquillapp/shadowquillapp.git
cd shadowquillapp
pnpm install
pnpm start
```
## Features
| Feature | Details |
|---------|---------|
| **8 Tabs** | Work on multiple prompts simultaneously |
| **7 Task Types** | General, Coding, Writing, Marketing, Research, Image, Video |
| **10 Default Presets** | Ready-to-use configurations for common workflows |
| **Preset Studio** | Create custom presets with live preview |
| **Version History** | Track prompt iterations with a visual timeline |
| **4 Themes** | Earth, Dark Purple, Dark, Light |
| **Gemma 3 Support** | 4B, 12B, 27B with auto-detection |
### Default Presets
`Daily Helper` • `Quick Summary` • `Code Helper` • `Bug Hunter` • `Email Draft` • `Research Assistant` • `Deep Analyst` • `Social Post` • `Image Creator` • `Video Creator`
### Keyboard Shortcuts
| Shortcut | Action |
|----------|--------|
| ⌘/Ctrl + T | New tab |
| ⌘/Ctrl + W | Close tab |
| ⌘/Ctrl + 1-8 | Switch tabs |
| ⌘/Ctrl + F | Find |
## Development
```bash
pnpm install # Install packages
pnpm run dev # Development mode
pnpm run build # Production build
pnpm start # Production mode
pnpm run test # Run tests
pnpm run typecheck # Type checking
pnpm run check # Lint with Biome
```
## Tech Stack
Next.js • Electron • Ollama • React • TypeScript • Tailwind CSS • Vitest • Biome
## Philosophy
- **Offline-First** — Fully operational without internet
- **Zero Telemetry** — No tracking or data collection
- **Local Storage** — All data stays on your machine
## Contributing
1. [Open an issue](https://github.com/shadowquillapp/shadowquillapp/issues) to discuss changes
2. Keep PRs focused and preserve the local-first architecture
