Skillget

ciana-parrot

agent
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 72 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Self-hosted AI assistant with multi-channel support, scheduled tasks, and extensible skills

README.md

CianaParrot

Self-hosted AI assistant with multi-channel support, scheduled tasks, and extensible skills.

Docs Website Python DeepAgents Docker MIT License

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 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

CianaParrot Architecture

Quick Start

One-command install

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

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, including:

  • Getting Started — Installation, setup, and first run
  • Architecture — Message flow, gateway system, persistence
  • Guides — Channels, bridges, skills, configuration, agent customization
  • Reference — API docs, config reference, Telegram commands
  • Contributing — Dev environment, testing, code style

License

MIT

Reviews (0)

No results found