📖Core ConceptsWhat is a Turtle?

What is a Turtle?

A Turtle is an autonomous AI that acts in the real world — created from a single sentence.

"Remind me to stand up every 25 minutes"

That one sentence becomes a Turtle. It watches, acts, and evolves — so you don't have to.


How it works

  • You describe what you want — in plain language, one sentence is enough
  • AI compiles it into executable code — your local LLM generates a JavaScript plan (called DNA)
  • It runs forever — as a background daemon on your machine, no cloud needed
  • It acts on the real world — controls your computer, smart home, APIs, and more
  • It evolves over time — observes patterns, reflects, and optimizes its own behavior

  • What makes Turtles different

    Not a chatbot. Turtles don't wait for you to ask questions — they take action autonomously. A Turtle will remind you to drink water, turn off your lights, or clean up your disk — without being prompted.

    Not a script. Turtles understand context. They adapt to your patterns over time. A PomodoroStand Turtle doesn't just set a timer — it learns when you actually take breaks and adjusts accordingly.

    Zero ongoing LLM cost. After the one-time compilation, your Turtle runs entirely on local code. No API calls, no token usage, no subscription fees.

    Local-first, always. Your Turtles run on your machine. Nothing is sent to any server unless you explicitly choose to deploy.


    A real example

    $ turtles create "Every hour, push me a new English word with definition and example"
    ✓ WordOfTheDay created and started (PID: 54321)
    
    $ turtles watch WordOfTheDay
    [09:00] 📖 ephemeral (adj.) — lasting for a very short time
            "The ephemeral beauty of cherry blossoms draws millions each spring."
    [10:00] 📖 serendipity (n.) — the occurrence of happy discoveries by accident
            "Finding that café was pure serendipity."

    One sentence. Runs forever. No maintenance required.