https://github.com/nikro/bip-pi
https://github.com/nikro/bip-pi
Last synced: 15 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/nikro/bip-pi
- Owner: Nikro
- Created: 2025-03-31T14:23:20.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-05T07:32:26.000Z (9 months ago)
- Last Synced: 2025-10-08T09:56:33.053Z (8 months ago)
- Language: Python
- Size: 241 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Reactive Companion System
A modular Python-based reactive companion system optimized for small single-board computers.
## Overview
This system uses three communicating processes via ZeroMQ:
1. **Awareness Node** - Monitors environment via audio/video
2. **Brains Node** - Processes triggers and generates responses
3. **UI Node** - Provides visual feedback and interaction
## Installation
Setup is simple with our all-in-one installation script:
```bash
git clone
cd reactive-companion
chmod +x install.sh
./install.sh
```
This will:
1. Set up a lightweight GUI environment (OpenBox)
2. Configure auto-login and display
3. Create the project structure
4. Set up Python environment with Poetry
5. Configure SSH for local network access only
## Using the System
After installation, you can run the components:
```bash
# The environment is automatically activated
cd ~/reactive-companion
# Start the UI
python -m src.ui.ui
# In separate terminals:
python -m src.awareness.awareness
python -m src.brains.brains
```
## Project Structure
- **awareness**: Environmental monitoring and trigger detection
- **brains**: Core processing and response generation
- **ui**: Pygame-based user interface
- **common**: Shared utilities and messaging infrastructure