---
title: Babble
emoji: 📊
colorFrom: gray
colorTo: pink
sdk: docker
app_port: 7860
app_file: app.py
pinned: false
short_description: Babble Telegram Bot
---

# Babble

Telegram AI character bot backend demo.

## Runtime

This Space runs as a Docker Space for FastAPI webhook reliability. The container starts:

```bash
uvicorn app:app --host 0.0.0.0 --port 7860
```

The Gradio landing demo is optional and mounted by the FastAPI app when Gradio is available. The Telegram webhook does not depend on Gradio.

## Character Menu

Babble now ships with persona presets, a custom character builder, and per-session memory.

Telegram commands:

- `/menu` shows the active persona and available presets
- `/persona <id>` switches the current persona preset
- `/character key=value ...` updates the current character profile
- `/reset` clears the session memory and custom overrides
- `/start` shows the current opening line

Character fields support `name`, `age`, `gender`, `style`, `voice`, `mood`, `boundaries`, and `opening`.

The bundled persona presets live in `data/personas.json`.

## Deployment Checks

Health check:

```bash
curl https://thewheke-babble.hf.space/health
```

Expected response:

```json
{"status":"ok","service":"babble"}
```

Set the Telegram webhook:

```bash
curl "https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/setWebhook?url=https://thewheke-babble.hf.space/telegram/webhook/<WEBHOOK_SECRET>"
```

Check Telegram webhook status:

```bash
curl "https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/getWebhookInfo"
```

Required Hugging Face Space secrets:

- `TELEGRAM_BOT_TOKEN`
- `WEBHOOK_SECRET`
- `LLM_PROVIDER=stub`
- `LLM_API_KEY=stub`

Optional debug endpoint:

- `/debug/config` exists only when `DEBUG=true`.
- It reports whether required settings are configured, but never returns secret values.

Useful environment variables:

- `PERSONA_ID`
- `PERSONAS_PATH`
- `MEMORY_ENABLED`
- `MEMORY_PATH`
- `MEMORY_MAX_TURNS`