v1.3.1 — Open Source — MIT License — 150+ Tools — Browser Automation

The Terminal AI Agent That Never Goes Down

35+ AI providers, 150+ tools, browser automation and persistent memory — all from your terminal, all in pure Python.

A powerful AI agent that runs in your terminal and browser. Multi-provider fallback, plugin system, persistent memory, and auto-learning — all in pure Python.

v1.3.1 includes: REST API, streaming, code analysis, Linear integration, intelligent caching, and much more.

bash — hellochusquis
$ pip install hellochusquis
✓ Successfully installed hellochusquis-1.6.0
$ hellochusquis
✓ Browser automation ready (human-like mouse)
✓ Plugin loaded: weather · stocks · browser · wikipedia
✓ Loaded 4 providers from config.yaml
You: find the best flight deals to Tokyo and book the cheapest one
→ browser_open(url='https://skyscanner.com')
→ browser_type(text='New York → Tokyo')
→ browser_click(text='Search')
✓ Found 47 flights, best price: €420
You:
pip install hellochusquis ★ GitHub
Featured on Uneed
120+ Integrations
35+ AI Providers
Python Pure Python
v1.3.1 Latest Version

Core Features

Everything you need. Nothing you don't.

Built from scratch in Python. No bloat, no unnecessary dependencies. Just a fast, reliable AI agent that works.

Core Agent

🔄
Multi-Provider Fallback
Automatically switches between 35+ AI providers when one fails or hits rate limits. Groq for speed, OpenRouter for tools, Ollama for local.
🧩
Plugin System
Install plugins with one command. Build your own with the AI-powered plugin builder. Submit to the public registry.
🧠
Persistent Memory
Remembers past conversations. Learns from its mistakes. Gets better with every session through automatic feedback analysis.
📋
Task Planner
Detects complex tasks automatically. Generates a step-by-step plan, shows it for confirmation, then executes each step autonomously.

Interfaces

🌐
Web Interface
Chat from your browser at localhost:8000. Sidebar shows provider status, installed plugins, memory stats, and learned patterns.

Automation

🔍
Browser Control
Open URLs, search the web, click buttons, fill forms. Real browser automation with human-like mouse movements (wobbles, bumps, variable speed).
📄
Real File Generation
Creates real PDF and Word documents — not text files with wrong extensions. Uses reportlab and python-docx under the hood.
📈
Real Stock Data
Historical stock data, price analysis, volatility metrics, and moving averages via yfinance. No simulated data.
🔒
Workspace Permissions
The agent only accesses directories you explicitly allow. Runtime permission requests for new paths. Your files stay safe.
⚡
Async Operations
Non-blocking shell commands and file operations for improved responsiveness and performance.
👁️
File Watcher
Automatically monitor files and directories for changes and trigger actions.
🛡️
Security Evaluator
AI-powered security checks prevent execution of potentially dangerous commands.
🗄️
Structured Memory
Persistent memory storage using SQLite for better organization and querying.
🎤
Voice Input
Speech-to-text input. Speak directly to the agent.
🔊
Voice Output
Text-to-speech output. Agent can read responses aloud.

Integrations

150+ tools.
100+ functions.
Auto-build on demand.

Native integrations for popular APIs. Missing one? Run `hellochusquis build` to create it with AI.

🐙
GitHub
Repos, issues, PRs, search. Full API access.
💬
Slack
Post messages, list channels, manage users.
🎮
Discord
Webhooks for notifications and alerts.
🐦
Twitter/X
Post tweets, search, timeline access.
📧
Gmail
Send emails, manage inbox, labels.
📋
Jira
Create issues, projects, workflows.
📊
Linear
Project management, team issues.
🗄️
PostgreSQL
Run queries, list tables, manage data.
🍃
MongoDB
NoSQL queries, collections, documents.
🐳
Docker
Containers, images, logs, management.
☁️
AWS
EC2, S3, Lambda, IAM operations.
📅
Google Calendar
Create events, list schedules.
📓
Notion
Pages, databases, content.
🎵
Spotify
Playback control, playlists.
🔍
Code Analysis
ESLint, Black, Ruff, MyPy integration.
🌐
Web Search
DuckDuckGo search inside terminal.
🖼️
Image Analysis
OCR, describe images with AI.
📊
Excel/Sheets
Read, write, analyze spreadsheets.
📈
Visualization
Generate charts and graphs.
🔐
Secret Scanner
Detect API keys in code.
⚙️
Kubernetes
K8s pods, deployments, services.
🏗️
Terraform
Infrastructure as Code.
🤖
RAG
Upload docs for context.
📝
Meeting AI
Summarize meetings, extract actions.
📨
Webhook
Send and receive webhooks.
📊
GraphQL
Execute GraphQL queries.

Auto-Tool Builder

Build integrations
on demand.

Need a new integration? HelloChusquis can build it for you automatically.

⚡
hellochusquis build
Create any integration with AI. Run `hellochusquis build` and describe what you need.
🎯
Smart Suggestions
When you ask for a missing tool, HelloChusquis proposes to build it.
🧩
Skills
Reusable workflows. Bundle commands into skills for automation.
🔌
MCP Support
Model Context Protocol for external AI tools and services.

AI Providers

35+ providers.
Automatic fallback.

Configure multiple providers. When one fails, HelloChusquis switches automatically. Free tiers supported on all major providers.

OpenRouter
Groq
Ollama (local)
OpenAI
Anthropic
Google Gemini
xAI (Grok)
Perplexity
Qwen / Alibaba
MiniMax
Baichuan
Zhipu (ChatGLM)
Moonshot
Mistral
DeepSeek
Cohere
Together AI
Fireworks AI
Novita AI
Lepton AI
Hyperbolic
SambaNova
Blackbox AI
Xiaomi MiMo
Replicate
HuggingFace
Anyscale
Beam
Azure OpenAI
AWS Bedrock
Vertex AI
Writer
Nomic
Custom / Other

Get Started

Three ways
to install.

Pick the method that works for you. All three end up with the same hellochusquis command in your terminal.

01 — Recommended
pip install
pip install hellochusquis

Requires Python 3.10+. Installs globally and adds the hellochusquis command.

02 — One liner
curl installer
curl -sSL https://raw.githubusercontent.com/aminoy77/HelloChusquis/main/install.sh | bash

Downloads and installs everything automatically. Works on macOS and Linux.

03 — Developer
git clone
git clone https://github.com/aminoy77/HelloChusquis.git && cd HelloChusquis && pip install -e .

For contributors. Editable install — your changes take effect immediately.

After installing

quick setup
$ hellochusquis --quick
╭─────────────────────────────────╮
│ Welcome to HelloChusquis! │
│ Quick setup — 60 seconds │
╰─────────────────────────────────╯
Get a free API key at: openrouter.ai/keys
Paste your OpenRouter API key:
✓ Ready. Starting HelloChusquis...