BLIMSEY

Use your old computer, Raspberry Pi—or even a shoe (haven’t tried, but who knows?)—to bring your AI assistant to life!

Transform it into whatever you want: a Tamagotchi companion, a language tutor, a professional assistant or developer — running locally, continuously learning, and as powerful as your CPU. Easy. Fast. 100% customizable. You choose the model, you set the focus.

Get started — it’s this simple:

# 1. Update system packages
sudo apt update
sudo apt upgrade -y

# 2. Install Git
sudo apt install git -y

# 3. Clone the Blimsey repo
git clone https://github.com/ac-craft8/blimsey.git
cd blimsey

# 4. Set up a Python virtual environment
python3 -m venv venv
source venv/bin/activate

# 5. Install requirements
pip install -r requirements.txt

# 6. Create config files
echo "YOUR_TELEGRAM_TOKEN" > telegram_token.txt
# (Optionally set up whitelist.txt, keywordPhrases.txt, settings.py, prompt.txt…)

# 7. Choose your model, customize the personality in prompt.txt

# 8. Run it!
python3 main.py