amigo / README.md
Jose Esparza
Changing `colorFrom` to `yellow`
c5fdab9 unverified
|
Raw
History Blame Contribute Delete
1.61 kB

A newer version of the Gradio SDK is available: 6.20.0

Upgrade
metadata
title: Amigo
emoji: πŸ‘‹
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 6.16.0
python_version: '3.12'
app_file: app.py
pinned: false
short_description: A private, local voice companion that knows you
models:
  - pebeto/amigo-lora

πŸ‘‹ Amigo

A privacy-first voice companion that runs on small models and knows the person it talks to. Built for the Build Small Hackathon.

My father uses Gemini. It confuses him, and it always needs the internet. Amigo works differently. He presses one big button and talks. It answers in his language, remembers him, keeps his data on the device, and goes online only for questions that need current facts.

How to use it

  1. Open Mi perfil and describe the person (the example shows the format).
  2. Press the big green button, speak, then press the red button to stop.
  3. Amigo replies out loud and shows the words in large text.

What runs here

🎀 mic β†’ faster-whisper (es) β†’ Qwen3.5-2B + amigo LoRA (llama.cpp)
           β”œβ”€ profile + Chroma memory (local)
           └─ DuckDuckGo search (only for current facts)
       β†’ Piper TTS (es) β†’ πŸ”Š speaker

This Space runs the small, fine-tuned amigo-2b (pebeto/amigo-lora on Qwen3.5-2B), chosen so replies stay quick on a CPU. Models download from the Hub on first boot, so the first load takes a few minutes.

The language is configurable in i18n.py (Spanish by default, English included). Set the MODEL_KEY variable to qwen3.5-4b to run the larger model instead.