Zootopians are the First Open-Source Digital Humans 👩🏽‍🤝‍👩🏼🧍

Help us build characters that are highly convincing, customizable, and dynamic — from boyfriend to personal secretary.

Make your own Twilio SMS Zootopian powered by Gemini LLM with Bing Search & Stripe Payment in minutes, not weeks ⚡

Check out our Zootopia character demos Boyfriend David Goggins

🌆 Features

• All LLMs supported (LiteLLM)
• Scalable agent DB architecture (Supabase)
• Bird SMS, Telegram

Behaviors

• Intent detection
• Auto DB
• Not responding to every single message
• Human-like memory
• Preference tracking
• Proactive messages
• Scheduling
• Vision

🛠️ Environment Setup

Make sure Python, ngrok, and uv are installed.

# 1 Navigate to the repository. Install [uv](https://github.com/astral-sh/uv):
pip install uv 

# 2. Create a virtual environment at .venv
uv venv  

# 3. Activate environment. 
source .venv/bin/activate # macOS and Linux
.venv\Scripts\activate # Windows

# 4. Install dependencies  
uv pip install -r requirements.txt

Copy local.template.yaml to a new file called local.yaml in the same directory Paste API keys into .env

🚀 Usage

Run the project:

python main.py

Interact with the demo:

• Add +1 (833) 819-1677 to contacts, or
• Add @AIHealthCoachBot on Telegram

Dependencies

Add new dependencies:

uv pip install [package_name]
uv pip freeze > requirements.txt

Contributors

License

MIT License.