{"id":37629569,"url":"https://github.com/danielfcollier/py-calango-ai","last_synced_at":"2026-01-16T10:55:37.051Z","repository":{"id":331639996,"uuid":"1129353850","full_name":"danielfcollier/py-calango-ai","owner":"danielfcollier","description":"A shapeshifting local AI interface. Chat with GPT-4, Claude, and local models. 🇧🇷 🦎","archived":false,"fork":false,"pushed_at":"2026-01-10T20:57:54.000Z","size":234,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T04:18:33.809Z","etag":null,"topics":["antrophic","brazil","gemini","llm","open-source","openai","python3","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielfcollier.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-07T01:17:08.000Z","updated_at":"2026-01-10T20:57:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/danielfcollier/py-calango-ai","commit_stats":null,"previous_names":["danielfcollier/py-calango-ai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/danielfcollier/py-calango-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielfcollier%2Fpy-calango-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielfcollier%2Fpy-calango-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielfcollier%2Fpy-calango-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielfcollier%2Fpy-calango-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielfcollier","download_url":"https://codeload.github.com/danielfcollier/py-calango-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielfcollier%2Fpy-calango-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478096,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["antrophic","brazil","gemini","llm","open-source","openai","python3","streamlit"],"created_at":"2026-01-16T10:55:35.919Z","updated_at":"2026-01-16T10:55:37.033Z","avatar_url":"https://github.com/danielfcollier.png","language":"Python","funding_links":["https://www.buymeacoffee.com/danielcollier"],"categories":[],"sub_categories":[],"readme":"# 🦎 Calango AI\n\n**Agile. Adaptable. Yours.**\n\n**Calango AI** is a free, open-source desktop application that lets you chat with the world's smartest Artificial Intelligences in a private, customizable environment.\n\nNamed after the agile Brazilian lizard, this app is built to be fast, resilient, and completely under your control. Unlike web chats, **you** own the data, **you** pick the personality, and **you** decide how it looks.\n\n## 🔭 Project Scope \u0026 Philosophy\n\nCalango AI is designed to be a **privacy-first LLM aggregator**. I believe that:\n\n1. **Your Data is Yours:** Chat history and API keys should live on your filesystem, not on a third-party cloud.\n2. **Agility is Key:** Switching between GPT-4, Claude 3.5, and a local Llama 3 should take one click.\n3. **Local First:** Prioritize features that run on your machine, reducing dependency on internet connection and subscription services where possible.\n\n## ✨ Why use Calango?\n\n* **🦎 Mimetismo (Mimicry):** Don't just chat with a robot. Use the **Persona Engineering** tab to turn your AI into a **Python Expert**, a **Creative Writer**, or a **Pirate Captain**. It adapts to your needs like a lizard blending into the leaves.\n* **🥊 A Rinha (The Ring):** Not sure which AI is smarter or cheaper? Pit **multiple models (up to 4)** against each other side-by-side in the arena to see who wins.\n* **🧬 DNA Injection:** Instantly configure your providers and preferences by uploading a `config.yaml` backup file.\n* **🧠 A Cuca (The Brain):** A comprehensive dashboard to track your token usage, costs, and chat history. \"She sees everything.\"\n* **🔒 Privacy First:** Your API keys and chat history are stored **locally on your computer**. I don't see them. Big Tech doesn't see them. Only you see them.\n* **💸 Pay As You Go:** Use your own API keys. This is often significantly cheaper than a fixed monthly subscription.\n\n## 🎨 The Brazilian Touch\n\nI've ditched the generic \"Dark Mode\" for themes that celebrate the vibrant colors of Brazil:\n\n* **🟩 Calango (Default):** The agile survivor of the Cerrado. (Signature Green/Dark)\n* **🟨 Girassol:** Inspired by the warm, vibrant sunflower fields. (Solar Yellow/Stone)\n* **🟪 Ipê:** The resilient purple tree that blooms in the winter. (Deep Purple)\n* **🟥 Tiê:** Inspired by the *Tiê-Sangue* (Brazilian Tanager).\n* **🟦 Gralha:** The *Gralha Azul* (Azure Jay), the planter of Araucaria forests.\n* **🌸 Boto:** The *Boto Cor-de-Rosa*, the shapeshifting legend of the Amazon.\n\n## 🛠️ For Developers (Quick Start)\n\nUse `make` to handle dependencies, environments, and local services.\n\n### Prerequisites\n\n* Python 3.10+\n* **Docker** (Required only if running Local LLMs/Ollama)\n\n### 1. Installation \u0026 Run\n\n```bash\n# Clone the repository\ngit clone [https://github.com/danielfcollier/calango-ai.git](https://github.com/danielfcollier/calango-ai.git)\ncd calango-ai\n\n# Install dependencies (creates virtualenv automatically)\nmake install\n\n# Run the Application\nmake run\n```\n\n### 2. Managing API Keys (The Secure Way)\n\nInstead of pasting keys into the UI every time, developers can use a `.env` file.\n\n1. Copy the example file:\n\n```bash\ncp .env.example .env\n```\n\n2. Edit `.env` and add your keys:\n\n```ini\nOPENAI_API_KEY=\"\u003cYOUR_API_KEY\u003e\"\nANTHROPIC_API_KEY=\"\u003cYOUR_API_KEY\u003e\"\nGOOGLE_API_KEY=\"\u003cYOUR_API_KEY\u003e\"\nGROQ_API_KEY=\"\u003cYOUR_API_KEY\u003e\"\n```\n\n\u003e **⚠️ CAUTION:** Never commit your `.env` file to version control! It is included in `.gitignore` by default to prevent accidental leaks.\n\n### 3. Local LLMs (Ollama + Docker)\n\nWant to run **Llama 3**, **Mistral**, or **Gemma** completely offline? I've provided a Dockerized Ollama setup.\n\n```bash\n# Pulls the Ollama image, starts the container, and downloads default models\nmake setup-ollama\n```\n\n*Once finished, select \"Ollama\" as your provider in the Calango UI.*\n\n### 4. Running Tests\n\nEnsure the architecture is sound before pushing changes.\n\n```bash\n# Run Unit Tests\npytest tests/unit\n\n# Run E2E UI Tests\npytest tests/e2e\n```\n\n## 🚀 How to Install (For Users)\n\nNo coding required. Just download and run.\n\n### **Windows**\n\n1. Download `CalangoAI_Windows.exe` from the **[Releases Page](https://www.google.com/search?q=https://github.com/danielfcollier/calango-ai/releases)**.\n2. Double-click to run.\n3. *Note:* If you see \"Windows protected your PC\", click **\"More Info\"** -\u003e **\"Run Anyway\"**.\n\n### **Mac**\n\n1. Download the `CalangoAI_MacOS` file.\n2. Right-click the file -\u003e **Open**.\n3. Click **Open** again to confirm.\n\n### **Linux**\n\n1. Download `CalangoAI_Linux`.\n2. Right-click -\u003e Properties -\u003e Permissions -\u003e Check **\"Allow executing file\"**.\n3. Run it.\n\n## 🗺️ Roadmap \u0026 Goals\n\nWe are actively evolving Calango from a local tool to a production-grade platform:\n\n* **🌍 Globalization:** Native multi-language support (English/Portuguese).\n* **🧠 Local RAG:** Give the AI \"Long-Term Memory\" by chatting with your local PDFs and documents.\n* **🔐 Identity \u0026 Control:** Multi-user support with authentication, quotas, and budgets.\n* **🗄️ Scalable Architecture:** Support for PostgreSQL and Async processing for high-performance deployments.\n\n## ⚡ Supported Providers\n\nCalango is the *engine*, but you need *gas* (an API Key) to run it.\n\n#### **Cloud Providers**\n\n* **Google Gemini:** [Get Key](https://aistudio.google.com/app/apikey) (Free tier available)\n* **OpenAI:** [Get Key](https://platform.openai.com/api-keys)\n* **Anthropic:** [Get Key](https://console.anthropic.com/settings/keys)\n* **Groq:** [Get Key](https://console.groq.com/keys) (High speed open-source models)\n\n#### **Local Providers**\n\n* **Ollama:** Runs locally via Docker (see Developer instructions).\n\n## ☕ Support the Project\n\nI am a Brazilian developer building open-source tools for the world. If you enjoy Calango AI, consider supporting the development!\n\n### 🇧🇷 Para Brasileiros (Pix)\n\n[☕  Me dê um café](https://livepix.gg/danielcollier)\n\n### 🌍 International Support\n\n[☕  Buy me a coffee](https://www.buymeacoffee.com/danielcollier)\n\n## ❓ FAQ\n\n**Where is my data stored?**\nEverything is saved in a hidden folder on your computer:\n\n* Windows: `C:\\Users\\You\\.calango\\`\n* Mac/Linux: `/home/you/.calango/`\n\n**Is this free?**\nThe software is 100% free and open source. However, cloud API keys (like OpenAI) may charge per message. Local models (Ollama) are free to run.\n\n**I found a bug!**\nPlease open an issue on our [GitHub page](https://www.google.com/search?q=https://github.com/danielfcollier/calango-ai).\n\n**Created by Daniel Collier**\n*Licensed under MIT License - Share freely!*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielfcollier%2Fpy-calango-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielfcollier%2Fpy-calango-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielfcollier%2Fpy-calango-ai/lists"}