Metadata-Version: 2.4
Name: nudge-ai
Version: 0.1.0
Summary: Voice assistant that actually gets things done. Speak, and Nudge handles the rest.
Project-URL: Homepage, https://nudge-ai.org
Project-URL: Repository, https://github.com/chiruu12/nudge
Project-URL: Issues, https://github.com/chiruu12/nudge/issues
Author: chiruu12
License: MIT
Keywords: ai-agent,productivity,speech-to-text,stt,voice-assistant
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.11
Requires-Dist: hive-agent[audio,hotkeys]>=0.4.2
Requires-Dist: python-dotenv>=1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: server
Requires-Dist: fastapi>=0.115; extra == 'server'
Requires-Dist: uvicorn>=0.30; extra == 'server'
Description-Content-Type: text/markdown

# Nudge

Voice assistant that actually gets things done. Speak, and Nudge handles the rest.

Built on [Hive](https://github.com/chiruu12/Hive), a local-first agent framework.

## Install

```bash
pip install nudge-ai
```

## Quick Start

```bash
# Interactive setup
nudge setup

# Start voice assistant
nudge

# Quick test (2s recording)
nudge test

# Load a preset
nudge preset fast      # Groq free tier
nudge preset offline   # Local inference (Ollama)
```

## Features

- **Voice-first** — Press a hotkey, speak, get things done
- **Tasks & Alarms** — Create todos, set reminders with your voice
- **Knowledge Base** — Save and recall notes with semantic search
- **Provider flexibility** — Groq, OpenAI, Anthropic, Ollama, LM Studio
- **Soul system** — Customize personality via `~/.nudge/soul.md`
- **Presets** — Switch between cloud/local/fast configs instantly

## Commands

```bash
nudge              # Start (hotkey mode)
nudge setup        # Interactive wizard
nudge test         # 2s live recording test
nudge config       # Show current config
nudge preset NAME  # Load preset (default/fast/offline)
nudge serve        # Start HTTP server
nudge history      # Show recent sessions
nudge soul show    # Display your soul.md
nudge soul edit    # Open soul.md in $EDITOR
```

## License

MIT
