AI Partner โ€” Autonomous Agent Platform
Self-hosted  ยท  Local-first  ยท  Production-ready

The Agent That
Actually Works

AI Partner is a self-hosted autonomous agent platform that researches, codes, generates documents, and delivers results to your apps โ€” without you babysitting it.

curl -fsSL https://raw.githubusercontent.com/Amitkrpaliwal/AI-Partner/main/setup.sh | bash
iwr -useb https://raw.githubusercontent.com/Amitkrpaliwal/AI-Partner/main/install.ps1 | iex
MIT Stars Last Commit Docker
ai-partner โ€” goal-execution
Core Features

Built different. Works different.

๐Ÿง 

Human-in-the-Loop

Agent pauses before running any script. Approve or reject via Telegram inline buttons. Also handles CAPTCHA hand-off, clarifications, and mid-execution input requests.

๐ŸŒ

Live Browser Automation

Full Puppeteer browser with 15fps live screencast. SPA-aware rendering, stealth mode. CAPTCHA detected? Agent pauses, you solve in the live panel, it resumes.

๐Ÿณ

Sandboxed Docker Execution

Every script runs inside a persistent container with Python, Node.js, and Bash. pandas, yfinance, matplotlib pre-loaded. Network isolation per-goal.

๐Ÿ“„

Document Generation

PDF via Chromium, multi-sheet XLSX, PowerPoint, and DOCX โ€” all production-ready, tracked in the dashboard, and instantly downloadable.

โšก

Skill Learning

After a successful goal, the system generalizes the solution into a reusable parameterized template. Versioned, deduplicated, and promotable to a callable tool.

๐Ÿค

Multi-Agent Delegation

Orchestrators spin up to 5 parallel sub-agents with budget controls. When a research agent exhausts its cap, it writes a handoff summary โ€” the parent picks up seamlessly.

๐Ÿ•

Scheduler + Proactive Agenda

Cron-expression tasks persist across restarts. The Proactive Agenda reads your task list and memory โ€” uses LLM judgment to pick the best action per tick.

๐Ÿงฌ

Vector Memory + RAG

Episodic log, vector search, persona traits, and periodic consolidation. Works with Ollama, OpenAI, Cohere, or pure-JS TF-IDF fallback โ€” zero API keys required.

๐Ÿ”Œ

17 Built-in MCP Servers

Browser, Shell, GitHub, Gmail, Calendar, Drive, Notion, Trello, Twitter, Spotify, Apify, Image Gen, Knowledge Base, Scheduler, and more. Plus any external MCP server.

How It Works

Goal in. Result out.

A 5-stage pipeline that turns natural language into validated, delivered outcomes.

1

Goal Extraction

Your natural-language goal is converted into a structured definition with typed, measurable success criteria โ€” file existence, content patterns, delivery receipts โ€” before a single action is taken.

2

Task Decomposition

Complex goals are broken into ordered sub-tasks with declared outputs. The right specialist agent is auto-selected by keyword or explicitly @mentioned.

3

Parallel Execution

Agents reason, pick tools, execute, and assess in a tight loop. Up to 5 sub-agents run in parallel. When a script fails, a semantic repair engine fixes it and retries.

4

Criteria-Based Validation

After every iteration the system checks real outcomes. The agent cannot self-report "done" โ€” it's done when filesystem, content, and messaging evidence all pass.

5

Delivery + Checkpoint

Results delivered to Telegram, Discord, Slack, or your workspace. State is checkpointed โ€” a restart picks up exactly where it stopped, all artifacts intact.

Agent Profiles

16 specialists. Zero generic.

@web-researcher
Web Researcher
Research
@fact-checker
Fact Checker
Research
@trend-spotter
Trend Spotter
Research
@python-dev
Python Developer
Dev
@node-dev
Node.js Developer
Dev
@debugger
Debugger
Dev
@shell-op
Shell Operator
Dev
@fin-analyst
Financial Analyst
Data
@data-analyst
Data Analyst
Data
@excel-builder
Excel Builder
Data
@report-gen
Report Generator
Content
@summarizer
Summarizer
Content
@tech-writer
Tech Writer
Content
@prompt-arch
Prompt Architect
Content
@task-planner
Task Planner
Content
@telegram-rep
Telegram Reporter
Delivery
Full Capabilities

What it can actually do

๐ŸŽฏ

Criteria-Based Completion

Goals close only when real-world evidence passes โ€” no self-reporting allowed.

๐Ÿ”

Dynamic Replanning

Fails a step? Replans, tries alternatives, semantically repairs scripts, retries.

๐Ÿ’พ

Checkpoint & Resume

State saved after each iteration. Restarts pick up exactly where they stopped.

๐Ÿ“ฒ

Telegram as Control Panel

Send goals, approve scripts, receive files โ€” all from Telegram, no UI needed.

๐Ÿค–

8 LLM Providers

Anthropic, Gemini, OpenAI, Ollama, LM Studio, Groq, DeepSeek, Perplexity.

๐Ÿ”—

Auto-Routing

Type @handle or just a keyword โ€” orchestrator routes to the right specialist.

๐Ÿ“Š

Full Audit Log

Every tool call, file write, script run, and approval logged. Full run history.

๐ŸŒ

Webhook + Event Triggers

Goals triggered by webhooks, Google Calendar events, or Gmail arrivals.

๐Ÿ–ผ๏ธ

AI Image Generation

DALL-E 3 or Stability AI from inside any agent workflow.

๐Ÿ“š

Knowledge Base (RAG)

Upload PDFs, URLs โ€” chunked, embedded, searched for grounded answers.

๐Ÿ”’

Security-First

URL safety checks, path guards, AES-256-GCM secrets, optional JWT auth.

โš™๏ธ

Zero-Config Local Mode

Points to local Ollama by default. Start free, add keys progressively.

Integrations

Connected to everything

One env var to activate any integration. Auto-discovered at startup.

๐Ÿ“ฌ
Telegram
Tasks, approvals, files
๐Ÿ’ฌ
Discord
Text & file delivery
๐Ÿ’ผ
Slack
Socket Mode
๐Ÿ“ฑ
WhatsApp
QR auth
๐Ÿ™
GitHub
Issues, PRs, code
๐Ÿ“
Notion
Read, create, query
๐Ÿ“…
Google Calendar
Events + triggers
๐Ÿ“ง
Gmail
Send, search, trigger
๐Ÿ’พ
Google Drive
Search, create
๐Ÿฆ
Twitter / X
Search, post, reply
๐ŸŽต
Spotify
Play, pause, queue
๐Ÿ•ท๏ธ
Apify
Proxy scraping
๐ŸŽจ
Image Gen
DALL-E 3 / Stability
Demo Flows

Real tasks. Real outcomes.

1

Daily Tech Briefing โ†’ Telegram

"Research today's top AI stories from HN + GitHub. Write a report and send to Telegram."

Full pipeline: research โ†’ PDF generation โ†’ validated Telegram delivery. Goal closes only after the file actually arrives.

Trend SpotterWeb SearchReport GenPDFTelegram
2

Live Stock Portfolio Snapshot

"Fetch closing prices for RELIANCE.NS, TCS.NS, INFY.NS. Build Excel with price, change%, 5-day chart."

Python + yfinance runs in Docker sandbox. Styled multi-sheet Excel with embedded chart. File criterion confirms output.

Financial AnalystyfinanceExcel BuilderXLSX
3

CAPTCHA-Protected Research

"Go to LinkedIn and find the top 5 posts about AI agents this week."

Browser navigates โ†’ CAPTCHA detected โ†’ Inspector opens โ†’ you solve in live preview โ†’ agent resumes and extracts content.

BrowserCAPTCHA HITLLive Screencast
4

Automated Weekly GitHub Report

Every Monday 9am โ†’ "Summarize commits, note open PRs, post summary to Slack."

Scheduler fires โ†’ GitHub data fetched โ†’ report written โ†’ Slack delivery. Set once, runs forever.

SchedulerGitHubReport GenSlack
5

Skill Learning: Instant Second Run

"Fetch NIFTY50 data and plot the last 30 days."

First run: Python from scratch. After success, system extracts a reusable template. Second run: template fills in โ†’ instant execution.

Skill LearningTemplatesTool Promotion
The Next Generation
🔒 Private โ€” not open-source
📅 Beta opens Q2 2026

The AI That
Acts AS You

V2 transforms AI Partner from an agent INTO your AI proxy. It joins your meetings, replies to your emails, handles your calls โ€” in your voice, with your judgment.

ai-partner โ€” human-proxy mode
Live Demo

Watch V2 Join a Real Meeting

No scripts. No staging. AI Partner joins a live call, listens in real time, and responds.

Who Is This For?

Built for busy professionals

๐ŸŽฏ Entrepreneurs & Founders

Double-booked by default? AI Partner attends meetings you can't make, follows up on your behalf, monitors your market while you sleep. Your time is your revenue โ€” stop wasting it on tasks that don't need you.

๐Ÿ’ผ Corporate CXO & Senior Leaders

Spend 6-8 hours daily in meetings most don't need your judgment โ€” just your presence. Send the proxy. It attends, flags blockers against your OKRs, captures decisions, and reports back in minutes.

What V2 Adds

Everything V1 does. Plus this.

New
๐ŸŽญ

Human Proxy โ€” Act AS You

AI Partner replies to your emails, Slack DMs, and Telegram messages IN YOUR VOICE. Gated by AuthorityPolicy + Telegram approvals for every action on your behalf.

New
๐Ÿ“น

Meeting Proxy โ€” Human in the Room

AI joins your Meet/Teams/Zoom calls, listens, responds in YOUR voice (voice clone), generates summaries, and extracts action items automatically.

New
๐Ÿ’ก

Proactive Heartbeat Engine

V2 doesn't wait to be asked. A background loop evaluates what to do every 15-30 minutes using your goals, memory, and real-time context.

Enhanced
๐Ÿ”ง

100+ Tools, 36 MCP Servers

From 17 servers in V1 to 36 in V2. Plus 4-tier computer use (DOM โ†’ Vision โ†’ Container Desktop โ†’ Host Control) with live CAPTCHA handoff.

New
๐Ÿ“ฑ

Phone Proxy โ€” Voicemail + Outbound

Answer calls on your behalf. Record, transcribe, summarize. Make outbound calls using your Twilio number and YOUR TTS voice.

Enhanced
๐Ÿง 

5-Layer Memory System

Episodic + Biographic + Counterparty + Vector + RAG. Understands who's who, what you've discussed, and maintains relationship context across all channels.

Enhanced
๐Ÿค–

18+ LLM Providers

From 8 providers in V1. Now including NVIDIA NIM, Cerebras (~100k tokens/s), OpenRouter (100+ models), MiniMax, and LiteLLM Proxy.

New
๐Ÿ“‹

Authority Policy + HITL

Declarative rules define what the agent does automatically vs. what needs your approval. Telegram inline buttons for every gray-zone decision.

Evolution

V1 vs V2 โ€” What's Changing?

V1 is live and production-ready. V2 is the next chapter.

Capability V1 โ€” Available Now V2 โ€” Coming Soon
LLM Providers8 providers18+ providers including NVIDIA NIM, Cerebras
Tools / MCP Servers100+ tools, 17 servers100+ tools, 36 servers
Agent Profiles16 agentsโœ“ Same + custom profiles
Human Proxyโ€”Act AS you on email, Slack, Telegram
Meeting Joinโ€”✓ Built & running โ€” private beta Q2 2026
Phone Proxyโ€”Voicemail + outbound calls
Proactive Engineโ€”Heartbeat + LLM agenda
Memory SystemVector + RAG5-layer (episodic + biographic + counterparty)
Computer UseBasic browser automation4-tier (DOM โ†’ Vision โ†’ T3 Container โ†’ Host)
Skill Learningโœ“ Automaticโœ“ Enhanced + version control
Authority Policyโ€”Per-action gating with Telegram approval
Self-Correctionโœ“ 3-retry semanticโœ“ Enhanced with stuck detection
Early Access

Be First for V2

📅 Private Beta โ€” Q2 2026 🔒 Not open-source โ€” invitation only

Secure your spot now. Early access members get first invites, exclusive onboarding, and direct founder contact.

🔥 Spots are limited โ€” once beta fills, waitlist closes.

Deployment

One command. Done.

Single Docker Compose. One API key minimum โ€” or use local Ollama for free.

8
LLM providers (V1)
17
MCP servers (V1)
16
Agent profiles
5
Messaging platforms
1
Command to deploy
0
Keys needed (Ollama)
Install V1 on your machine
curl -fsSL https://raw.githubusercontent.com/Amitkrpaliwal/AI-Partner/main/setup.sh | bash
iwr -useb https://raw.githubusercontent.com/Amitkrpaliwal/AI-Partner/main/install.ps1 | iex
MIT Stars Issues Last Commit Docker Opens at http://localhost:3000 โ€” no config needed
Stay Updated

Get notified when demos ship

New features, demo drops, and the public release โ€” straight to your inbox.

๐Ÿ”’ No spam. Unsubscribe anytime.

Your AI partner is ready.
Are you?

Self-hosted. Local-first. No subscriptions. No cloud lock-in.