openturtles

v0.12.0

Published

a month ago

OpenTurtles CLI — AI That Acts in the Real World. Say one sentence, get an AI agent that runs forever.

0High
0Medium
0Low

openturtles

ai agents autonomous cli turtles openturtles automation smart-home ai-agent

OpenTurtles

Say one sentence. Get an AI that acts on it — forever.

AI That Acts in the Real World.

Website · Documentation · Live Map · Explore Turtles

✨ What is OpenTurtles?

OpenTurtles turns a single sentence into a living, autonomous AI agent — a Turtle — that watches your world, acts on it, and evolves over time.

"Remind me to stand up every 25 minutes." "Turn off the lights when I leave the room." "Catch me slacking off and nudge me back."

One sentence creates a Turtle. It runs in the background, observes your environment, takes action, and gets smarter the longer it lives — so you don't have to.

A Whole New Quadrant

Not a chatbot. Not a cron job. Not a dev framework. OpenTurtles creates something entirely new.

| | Stops After Reply | Acts Forever | | :-------------------- | :------------------------------------------------------------- | :---------------------------------------------------------------------------- | | Natural Language | 💬 ChatGPTConversational AIAnswers once, then stops | 🐢 OpenTurtles ✦ New QuadrantOne sentence · Compile onceWatches, acts, evolves — forever | | Requires Coding | 🔧 LangChain / AgentsDeveloper frameworkCalls LLM every time, requires code | ⏰ Cron / RPAFixed scriptsNo understanding, no evolution |

🚀 Installation

One-line install (macOS / Linux)

curl -fsSL https://openturtles.ai/install.sh | bash

Manual download

Grab a prebuilt binary from the latest release:

tar -xzf turtles-v0.12.0-<platform>.tar.gz
sudo mv turtles /usr/local/bin/
turtles --version

⚡ Quick Start (5 minutes)

Get your first Turtle running in 3 steps.

Step 1 — Log in

$ turtles login
✓ Logged in as openturtles

Step 2 — Create a Turtle

$ turtles create "Remind me to drink water every hour from 9am to 6pm"
⠋ Compiling...
✓ WaterReminder created and started (PID: 12345)

Step 3 — Watch it run

$ turtles watch WaterReminder
[09:00] 💧 Reminder: Time to drink water!
[10:00] 💧 Reminder: Time to drink water!
[11:02] 💧 Reminder: Time to drink water!

That's it. Your Turtle is running in the background, forever.

Deploy it to OpenTurtles (optional)

Push it to your dashboard or share it on the Live Map:

$ turtles deploy WaterReminder

  🐢 Deploying WaterReminder to OpenTurtles

  Visibility:
  ❯ Public — visible on your profile and discoverable by anyone
    Private — only visible to you on your dashboard

  ✓ Deployed WaterReminder to OpenTurtles!

  View on OpenTurtles:
    https://openturtles.ai/openturtles/WaterReminder

Deploying is entirely optional — your Turtle works the same whether deployed or not.

🧠 From Zero to Act

No code. No config files. Just one sentence.

3 steps — that's it

01 · Say What You Want Describe what you need in plain language.

"Remind me to stand up every 25 minutes"

02 · AI Compiles It AI understands your intent and generates a live turtle. Compiled once. Runs forever. Zero ongoing cost.

03 · It Watches, Acts, Evolves Runs in the background. Observes your world, takes action, and gets smarter over time.

See it in action

# Step 1 — Create a Turtle with one sentence
$ turtles create "Turn on heater below 18°C, AC above 26°C"
  ⠋ Compiling...
  ✓ HomeKeep created & started (PID: 12345)

# Step 2 — Watch it work in real-time
$ turtles watch HomeKeep
  [14:30] 🐢 HomeKeep │ 🌡️ 21.5°C — normal range
  [14:31] 🐢 HomeKeep │ 🧬 Auto-evolved: weekend threshold 17°C
  [22:00] 🐢 HomeKeep │ 💡 You left — turned off 3 lights

# Step 3 — Deploy to the global network
  ✓ Deployed to https://openturtles.ai/@openturtles/HomeKeep
  🌍 Now visible on the Global Turtle Network

🌱 Self-Evolution Timeline

A Turtle isn't a script. It's a living process. Here's what happens after you create one:

| Phase | What it does | | :--------- | :------------------------------------------------------------------------ | | Day 7 | Starts recording environment data (observe("idle_seconds", 16.7, ...)) | | Day 30 | Discovers patterns ("weekend idle threshold is longer") | | Day 90 | Auto-tunes its own config variables (AWAY_THRESHOLD: 300→240, confidence 0.92) | | Day 365| Fully autonomous. Hundreds of evolutions. Zero human intervention. |

Only configuration variables evolve — never the logic. Your Turtle gets smarter without ever going rogue.

🐢 What You Can Build

A few real examples from the community — every one of them is a single sentence away.

Browse the full catalog on the Explore page.

📦 Releases

Current version: v0.12.0
Install URL: https://openturtles.ai/install.sh
All releases: https://github.com/openturtles/cli/releases

🗺️ Roadmap & Status

All 15 foundational milestones (M1–M15) are ✅ complete and shipped in v0.12.0.

📖 Documentation

Full documentation lives at https://openturtles.ai/docs.

🚀 Getting Started

📖 Core Concepts

⌨️ CLI Reference

🔌 Connect

LLM Providers — Configure LLM servers for DNA compilation. Built-in support for OpenAI, Anthropic, Ollama (local), and any OpenAI-compatible endpoint (DeepSeek, Groq, Together…). Multi-server with one-command default switching.
MCP Servers — Connect Model Context Protocol servers to extend Turtles with external tools — filesystems, databases, APIs, dev tools, and more. Supports stdio, HTTP, and SSE transports.
Skills — Markdown-based behavioral instructions (SKILL.md) that teach Turtles how to act, not just what to do. Install from a local directory or the ClawHub community registry.
Home Assistant — Let your Turtles control smart home devices — lights, sensors, climate, switches, media players. Multi-instance (e.g. home + office) with auto entity discovery.

🐢 Use Cases Health · Productivity · System · Dev · Data · Journal · Security · Learning · Automation

💬 Feedback & Support

We'd love to hear from you. Bug reports, feature requests, and product feedback are always welcome.

📮 Feedback / Support — [email protected]
🐦 Twitter / X — @openturtles
🗺️ Live Map — https://openturtles.ai/live (see Turtles running around the world, city-level anonymized)
🐢 Share your Turtle — turtles deploy <name> — make it discoverable on the Explore page

📄 License

OpenTurtles is a proprietary product. The turtles binary is provided free of charge for personal and commercial use, subject to the Terms of Service. Redistribution, reverse engineering, or derivative works are not permitted without prior written consent.

Our vision: building the first Global Reality AI Network — millions of Turtles, observing, acting, and evolving across the real world.

Made with 🐢 by the OpenTurtles team.