Skip to content

Latest commit

Β 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– My Machine Bot

A local AI chatbot powered by Ollama that can tell you about your system. Everything runs locally on your machine - no data is sent to the cloud.

Features

  • πŸ’¬ Chat with a local LLM (Llama 3.2)
  • πŸ’» Get real-time system information:
    • CPU usage and specs
    • Memory (RAM) usage
    • Disk space and partitions
    • Network interfaces and stats
    • Running processes
    • Battery status (laptops)
    • System uptime
  • πŸ”’ 100% local - your data never leaves your machine
  • 🎨 Beautiful terminal UI with Rich

Prerequisites

  • Python 3.10+
  • Ollama installed and running

Installation

  1. Install Ollama (if not already installed):

    brew install ollama
  2. Start Ollama service:

    brew services start ollama
  3. Clone this repository:

    git clone https://github.com/Focus-Key-Exe/my-machine-bot.git
    cd my-machine-bot
  4. Create a virtual environment (recommended):

    python -m venv venv
    source venv/bin/activate
  5. Install dependencies:

    pip install -r requirements.txt

Usage

Run the chatbot:

python chat.py

On first run, it will automatically download the Llama 3.2 model (~2GB).

Example Questions

  • "How much RAM am I using?"
  • "What's my CPU usage right now?"
  • "Show me my disk space"
  • "What processes are using the most memory?"
  • "What's my IP address?"
  • "How long has my computer been running?"
  • "Tell me about my system"

Changing the Model

You can use a different Ollama model by editing the MODEL variable in chat.py:

MODEL = "llama3.2"  # Change to any model you have

Popular alternatives:

  • mistral - Fast and capable
  • llama3.2:1b - Smaller/faster variant
  • codellama - Better for code-related questions

Project Structure

my-machine-bot/
β”œβ”€β”€ chat.py           # Main chatbot application
β”œβ”€β”€ system_tools.py   # System monitoring functions
β”œβ”€β”€ requirements.txt  # Python dependencies
β”œβ”€β”€ .gitignore
└── README.md

Adding New Tools

You can add new system tools by:

  1. Creating a new function in system_tools.py
  2. Adding it to the TOOLS dictionary
  3. The bot will automatically be able to use it!

License

MIT License - feel free to use and modify as you like!

Contributing

Contributions welcome! Feel free to open issues or pull requests.

About

πŸ€– A local AI chatbot powered by Ollama that monitors and reports on your system β€” CPU, memory, disk, network, and more. 100% private, runs entirely on your machine.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages