https://github.com/emanueleielo/ciana-parrot
Self-hosted AI assistant with multi-channel support, scheduled tasks, and extensible skills
https://github.com/emanueleielo/ciana-parrot
ai-agent ai-assistant automation chatbot claude-code docker langchain open-source personal-ai python self-hosted telegram-bot
Last synced: 3 months ago
JSON representation
Self-hosted AI assistant with multi-channel support, scheduled tasks, and extensible skills
- Host: GitHub
- URL: https://github.com/emanueleielo/ciana-parrot
- Owner: emanueleielo
- License: mit
- Created: 2026-02-15T17:36:34.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-21T12:51:56.000Z (3 months ago)
- Last Synced: 2026-03-22T03:36:02.889Z (3 months ago)
- Topics: ai-agent, ai-assistant, automation, chatbot, claude-code, docker, langchain, open-source, personal-ai, python, self-hosted, telegram-bot
- Language: Python
- Homepage: https://cianaparrot.dev
- Size: 1.17 MB
- Stars: 68
- Watchers: 1
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-LangGraph - emanueleielo/ciana-parrot - hosted AI personal assistant with Telegram integration, scheduled tasks, multi-provider LLM support, and MCP server integration |  | (🏢 Workplace & Productivity / 🟩 Development Tools 🛠️)
README
Self-hosted AI assistant with multi-channel support, scheduled tasks, and extensible skills.
---
CianaParrot is a self-hosted AI personal assistant that runs on your own infrastructure — sandboxed inside Docker, but connected to your OS through secure bridges. Built on the [DeepAgents](https://github.com/deepagents/deepagents) framework with LangChain/LangGraph, it combines interactive chat via Telegram with autonomous scheduled tasks — all configured through a single YAML file.
## Features
- **Multi-provider LLM** — Anthropic, OpenAI, Google Gemini, Groq, Ollama, OpenRouter, vLLM
- **Multi-tier model routing** — Configure multiple LLM tiers (lite → expert) and let the agent switch models mid-conversation for cost optimization
- **Multi-channel** — Pluggable channel architecture, Telegram out of the box
- **Host gateway** — Secure bridge system connecting the Docker sandbox to host CLI tools (Spotify, Reminders, iMessage, Things, Bear Notes, Obsidian, 1Password, HomeKit, and more)
- **Scheduled tasks** — Cron, interval, and one-shot tasks the agent can create via chat
- **Skills system** — Drop a folder in `skills/` and it auto-registers as agent tools
- **MCP support** — Connect external MCP servers for unlimited extensibility
- **Persistent memory** — Markdown-based identity and memory the agent updates itself
- **Observability** — Optional LangSmith tracing
- **Docker-only deploy** — One command to build, one to run
## Architecture
## Quick Start
### One-command install
```bash
curl -fsSL https://raw.githubusercontent.com/emanueleielo/ciana-parrot/main/install.sh | bash
```
This handles everything: prerequisites check, repo clone, `.env` setup (prompts for API keys), Docker build, and host gateway startup.
> **Flags:** `bash install.sh --dry-run` to preview without changes, `--no-prompt` for non-interactive/CI usage.
### Manual setup
```bash
git clone https://github.com/emanueleielo/ciana-parrot.git
cd ciana-parrot
cp .env.example .env # Edit with your API keys
make build && make up # Build and start
make gateway # Start host gateway (optional)
```
Open your bot on Telegram, send `/start`, and start chatting.
## Documentation
Full documentation is available at **[docs.cianaparrot.dev](https://docs.cianaparrot.dev)**, including:
- [Getting Started](https://docs.cianaparrot.dev/getting-started/) — Installation, setup, and first run
- [Architecture](https://docs.cianaparrot.dev/architecture/) — Message flow, gateway system, persistence
- [Guides](https://docs.cianaparrot.dev/guides/) — Channels, bridges, skills, configuration, agent customization
- [Reference](https://docs.cianaparrot.dev/reference/) — API docs, config reference, Telegram commands
- [Contributing](https://docs.cianaparrot.dev/contributing/) — Dev environment, testing, code style
## License
MIT