Metadata-Version: 2.4
Name: nullsec-dr-marshall
Version: 2.2.0
Summary: Dr. Marshall — friendly local AI assistant powered by Ollama (from Frisc OS)
Project-URL: Homepage, https://github.com/bad-antics/frisc-os
Project-URL: Repository, https://github.com/bad-antics/frisc-os
Project-URL: Bug Tracker, https://github.com/bad-antics/frisc-os/issues
Author-email: bad-antics <bad-antics@users.noreply.github.com>
License: GPL-3.0-or-later
Keywords: accessibility,ai,assistant,offline,ollama,reading,spelling
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: GTK
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Requires-Dist: requests>=2.28
Provides-Extra: gtk
Requires-Dist: pygobject>=3.42; extra == 'gtk'
Provides-Extra: spell
Requires-Dist: pyspellchecker>=0.7; extra == 'spell'
Provides-Extra: voice
Requires-Dist: pyttsx3>=2.90; extra == 'voice'
Description-Content-Type: text/markdown

# nullsec-dr-marshall

**Dr. Marshall** is a friendly, patient AI assistant built into [Frisc OS](https://github.com/bad-antics/frisc-os). He speaks in plain English, avoids jargon, and is always ready to help with reading difficult text, checking spelling, and explaining things simply.

Powered by local [Ollama](https://ollama.com) models — **100% private, works completely offline**.

## Features

- 💬 Conversational AI via Ollama (llama3, mistral, gemma, etc.)
- 📖 Reading helper — simplifies and explains complex text
- ✏️ Spelling checker and autocorrect
- 🔊 Optional voice output (text-to-speech)
- 🖥️ GTK3 desktop UI (optional) or headless CLI mode
- 🔒 No cloud, no telemetry, fully local

## Requirements

- Python 3.9+
- [Ollama](https://ollama.com) running locally (`ollama serve`)
- GTK3 + PyGObject (optional, for desktop UI)

## Installation

```bash
pip install nullsec-dr-marshall
```

With optional dependencies:

```bash
pip install "nullsec-dr-marshall[gtk,voice,spell]"
```

## Usage

```bash
dr-marshall
```

Or as a module:

```bash
python -m nullsec_dr_marshall
```

## Part of Frisc OS

Dr. Marshall is a component of [Frisc OS](https://github.com/bad-antics/frisc-os), a lightweight Linux distribution designed for accessibility and ease of use.

## License

GPL-3.0-or-later
