https://github.com/zefir1990/coverseer
Cli tool to ai - ollama overseer command and restart until success
https://github.com/zefir1990/coverseer
ai cli ollama
Last synced: 6 days ago
JSON representation
Cli tool to ai - ollama overseer command and restart until success
- Host: GitHub
- URL: https://github.com/zefir1990/coverseer
- Owner: zefir1990
- License: mit
- Created: 2026-01-17T11:24:54.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-01-17T12:17:33.000Z (4 months ago)
- Last Synced: 2026-02-21T21:20:27.147Z (3 months ago)
- Topics: ai, cli, ollama
- Language: Python
- Homepage: https://demensdeum.com
- Size: 6.84 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# coverseer
`coverseer` is a process monitor that uses Ollama to analyze the output of a child process and automatically restart it if it detects errors, hangs, or crashes.
## Features
- **LLM-Powered Monitoring**: Uses Ollama (default: `gemma3:4b-it-qat`) to understand process health beyond simple exit codes.
- **Auto-Restart**: Kills and restarts the process if the LLM identifies a failure state or if the process exits with a non-zero code.
- **Detailed Logging**: Captures and logs all output from the child process.
- **Standalone Executable**: Supports building a single-file `.exe` for Windows.
## Requirements
- Python 3.12+
- [Ollama](https://ollama.com/) running locally.
- **`gemma3:4b-it-qat`** model pulled in Ollama (`ollama pull gemma3:4b-it-qat`).
- Python packages: `requests`, `ollama-call`.
## Usage
### Running with Python
```bash
python coverseer.py "your command here"
```
Example:
```bash
python coverseer.py "ollama pull gemma3:4b-it-qat"
```
### Configuration
You can edit `coverseer.py` to change:
- `CHECK_INTERVAL_SECONDS`: How often to poll Ollama for health checks (default: 5s).
- `MAX_OUTPUT_LINES`: How many lines of history to send to Ollama (default: 100).
- `OLLAMA_MODEL`: Which model to use (default: `gemma3:4b-it-qat`).
## Building the Executable
To create a standalone `coverseer.exe`:
1. Install PyInstaller:
```bash
pip install pyinstaller
```
2. Run the build script:
```bash
.\build_exe.bat
```
3. The executable will be in the `dist/` directory.
## License
MIT