OpenTeddy

A free, Claude-like agent

Local models + skills + a dash of commercial LLM

Python 3.10+ FastAPI Ollama Claude MIT License

New · v1.1.3

Native macOS desktop app

One-click install. No Python venv, no Ollama CLI — just drag the .app into Applications and launch.

Download for Mac (.dmg)

Apple Silicon · ~100 MB Signed & notarized Release notes

or install via command line

Install in one line

$ curl -fsSL https://openteddy.net/install | bash

$ git clone https://github.com/m31527/OpenTeddy.git
cd OpenTeddy
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
./run.sh --open

$ git clone https://github.com/m31527/OpenTeddy.git
cd OpenTeddy && docker build -t openteddy .
docker run --rm -p 8000:8000 -v openteddy-data:/data openteddy

# # Homebrew formula is on the roadmap — Q3 2026.
# In the meantime, the curl one-liner is the equivalent zero-setup path:
$ curl -fsSL https://openteddy.net/install | bash

Idempotent · No sudo · All files scoped to ~/OpenTeddy · Audit with --dry-run

Star on GitHub Learn More

About OpenTeddy

Named after Teddy, built for everyone.

Teddy is our family dog — a forever-young red poodle who has been part of our lives for many years. He's smart, gentle, loyal, and always brings warmth to the people around him.

When we started building OpenTeddy, we wanted the project to carry the same spirit.

OpenTeddy was created with a simple belief: powerful AI should belong to everyone, not only to those who can afford expensive APIs or become dependent on a single provider.

Our goal is to help anyone build their own AI assistant — something as capable and personal as Claude, but running on their own hardware, under their own control.

We believe your computer should be able to do more than browse the web and run applications. It should become a platform for creativity, learning, automation, and intelligence. Whether you're running a laptop, a workstation, or a GPU server, OpenTeddy helps you unlock the full potential of your hardware and your ideas.

OpenTeddy is more than an AI tool.

It's a step toward a future where everyone can own, customize, and benefit from AI without limits.

Our Mission

Build a free, Claude-like experience that anyone can run at home. We achieve this by mixing three powerful layers:

Local Models

Gemma / Qwen via Ollama handle planning and execution — no per-token cost, no data leaving your machine.

Skills

Turn repeated work into Python functions, eliminating LLM calls after the second or third run.

Claude Escalation

Commercial model pulled in only when local path genuinely can't finish — timeouts, failures, low confidence.

The result: high capability at a fraction of the cost of calling a frontier model for every single step.

Key Highlights

Local-First

Planning and execution run on your machine via Ollama

Auto-Escalation

Timeouts and failures trigger Claude intervention automatically

Self-Growing Skills

Repeated tasks become reusable Python skills, cutting LLM calls

Web Dashboard

Submit tasks, watch tool calls stream live, manage settings

Human-in-the-Loop

High-risk shell commands pause for approval before running

Persistent Memory

ChromaDB-backed long-term memory feeds context into future plans

Any Cloud Provider

Claude, OpenAI, Gemini, Deepseek, or OpenRouter — swap providers from Settings at runtime

PDF & Databases

Drop in a PDF for page-cited answers, or connect Postgres / MySQL / SQLite with destructive SQL hard-blocked

Drive from Telegram

Send goals from your phone and get live progress, summaries, and downloadable artifacts back

Watch Demo

See OpenTeddy in action with this comprehensive walkthrough

See It In Action

Powerful capabilities that save you money while enabling unlimited creativity

Save Your Money

Track your token usage and see exactly how much you're saving compared to using GPT-4 for every task. The hybrid approach keeps costs low while maintaining high quality.

Real-time cost tracking
Compare with GPT-4 pricing
See savings accumulate over time

Generate Reports

Automatically generate comprehensive reports from your data. OpenTeddy can analyze, visualize, and create professional documents.

Data analysis and visualization
Automated report generation
Professional formatting

Testing & Development

Handle complex development tasks including testing, debugging, and data processing. Skills grow automatically to handle repeated workflows.

Automated testing workflows
Data processing pipelines
Self-improving skills

Architecture

One task, three stages. The agent reads your session settings, plans the work locally, runs a guarded execution loop that escalates to a cloud LLM only when local genuinely can't deliver, then wraps up with verification + memory write-back.

OpenTeddy agent lifecycle: Planning stage (orchestrator reads session, recalls memory, splits into subtasks) → Execution loop (local Qwen executor with 5 guards, escalates to cloud LLM on failure) → Wrap-up stage (build tool log, generate summary, run confirmation checks, add to memory)

A. Timeout
Subtask exceeds 900 s wall / 180 s silence.

B. Low Confidence
Qwen reports < 0.6 (or hard-fail clamped to 0.3).

C. Failure Signal
Tool output contains command not found, unhealthy, etc.

D. Empty Artifact
"Build X" task produced zero files in workspace.

E. Deliverable Judge
LLM-as-judge says the produced file isn't the real artifact.

Up and running in minutes

Three steps from download to your first finished task. No terminal expertise required.

Download & install

Grab the signed macOS app, or run the one-line installer on Linux / WSL2. No Python venv to wrangle.

Pick your models

The onboarding wizard installs Ollama and pulls the right local model preset for your hardware. Add a cloud key anytime.

Your agent is live

Submit your first goal and watch tool calls stream live. Skills grow themselves as you keep working.

Install OpenTeddy Read the docs

22 locales

Speaks your language

The dashboard and desktop app ship fully localized across 22 locales — including region-specific variants — so your agent feels native wherever you are.

🇹🇼繁體中文台灣

🇨🇳简体中文中国大陆

🇭🇰繁體中文香港

🇸🇬简体中文新加坡

🇺🇸EnglishUS

🇬🇧EnglishUK

🌐EnglishGlobal

🇯🇵日本語日本

🇰🇷한국어한국

🇪🇸EspañolEspaña

🌎EspañolLatinoamérica

🇫🇷FrançaisFrance

🇨🇦FrançaisQuébec

🇩🇪DeutschDeutschland

🇮🇹ItalianoItalia

🇵🇹PortuguêsPortugal

🇧🇷PortuguêsBrasil

🇷🇺РусскийРоссия

🇮🇩Bahasa IndonesiaIndonesia

🇻🇳Tiếng ViệtViệt Nam

🇲🇾Bahasa MelayuMalaysia

🇹🇭ภาษาไทยประเทศไทย

Ready to Get Started?

OpenTeddy is a solo side-project trying to prove that a small open stack can get close to the big commercial agents.

Star on GitHub Quick Start Guide

Star the Repo

The single biggest encouragement for the project

Open an Issue

Report bugs or share feedback

Share a Skill

Contribute your custom skills via PR