An open API service indexing awesome lists of open source software.

https://github.com/arinbjornk/llmtop

A system monitoring tool powered by LLMs that provides real-time insights about your system's performance
https://github.com/arinbjornk/llmtop

ai-tools gputil ollama openai psutil rich system-monitoring terminal

Last synced: 2 months ago
JSON representation

A system monitoring tool powered by LLMs that provides real-time insights about your system's performance

Awesome Lists containing this project

README

        

# llmtop

`llmtop` is an intelligent system monitoring tool that combines real-time system metrics with LLM-powered insights. It provides a dynamic terminal interface showing system performance metrics enhanced with AI-driven analysis.

> **Note**: This project is currently in beta testing. Features and interfaces may change.

![llmtop Screenshot](screenshot.png)

## Features

- Real-time system metrics monitoring (CPU, Memory, Disk, Network)
- Process monitoring with resource usage
- AI-powered system analysis using either OpenAI or Ollama
- Smart alerting system for resource thresholds
- Dynamic terminal UI with auto-updating metrics

## Installation

Install directly from PyPI:
```bash
pip install llmtop
```

## LLM Backend Options

llmtop supports two LLM backends for system analysis:

### OpenAI (GPT-4o mini)
1. Set your OpenAI API key:
```bash
export OPENAI_API_KEY='your-api-key-here'
```
2. Run with OpenAI:
```bash
llmtop --use-openai
```

### Ollama with Llama 3.2 3B (Default)
1. Install Ollama from [ollama.ai](https://ollama.ai)
2. Start the Ollama service
3. Run llmtop:
```bash
llmtop
```

## Command Line Options

```bash
llmtop [OPTIONS]

Options:
--update-frequency INTEGER Update frequency in seconds (default: 5)
--use-openai Use OpenAI instead of local model
--history-length INTEGER Number of historical data points to keep (default: 60)
--help Show this message and exit
```

## Usage Tips

- The tool defaults to using Ollama for analysis, which is free but requires local installation
- OpenAI mode provides more detailed analysis but requires an API key and has associated costs
- Adjust update frequency based on your system's performance and monitoring needs

## Known Issues

- Experimental (untested) support for Windows systems
- Update frequency might need adjustment on slower systems
- Some process names may be truncated in the display

## Contributing

This project is in beta, and we welcome contributions! Please feel free to:

- Report bugs
- Suggest features
- Submit pull requests

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Acknowledgements

Built using:
- Rich for terminal UI
- OpenAI/Ollama for LLM integration
- psutil for system metrics