Skip to content

Latest commit

 

History

31 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pip-Pi Assistant

A desktop AI assistant built with Python, featuring real-time system monitoring, theme customization, and an animated ASCII face interface.

Features

  • Interactive chat interface with multiple AI personalities
  • Real-time system monitoring (CPU and memory usage)
  • Customizable themes
  • Animated ASCII face expressions
  • Audio feedback
  • Cross-platform compatibility

Prerequisites

  • Python 3.8 or higher
  • Ollama installed and running locally

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/pip-pi.git
cd pip-pi
  1. Create and activate a virtual environment:
# Windows
python -m venv venv
venv\Scripts\activate

# macOS/Linux
python -m venv venv
source venv/bin/activate
  1. Install required packages:
pip install -r requirements.txt
  1. Install required Ollama models:
ollama pull gemma2:2b
ollama pull deepseek-r1:7b

Running the Application

  1. Ensure Ollama is running:
ollama serve
  1. Start Pip-Pi:
python ada_mini.py

Key Dependencies

  • customtkinter
  • matplotlib
  • pygame
  • Pillow
  • psutil
  • requests

Configuration

  • Settings are stored in settings.json
  • Theme configurations are located in the themes directory
  • AI personalities can be configured in personalities/ai_config.json

License

GNU General Public License v3.0

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

About

Dumb little AI chatbot I built to teach me some stuff.

Topics

Resources

Stars

1 star

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages