ciana-parrot
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 72 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Self-hosted AI assistant with multi-channel support, scheduled tasks, and extensible skills
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 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
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-runto preview without changes,--no-promptfor 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
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi