freshcrate
Skin:/
Home > AI Agents > eternego

eternego

The Eternego codebase

Why this rank:Recent releaseHealthy release cadenceStrong adoption

Description

The Eternego codebase

README

Eternego — The Eternal I

The missing piece in AI isn't more intelligence. It's alignment over time.

You've told the same model your timezone fourteen times.
It forgets you have kids. It doesn't know how you think, what frustrates you, or what matters most.
Every conversation resets. Your life stays scattered — or trapped on someone else's servers.

Eternego is different.

It's a personal AI persona that lives entirely on your hardware.
It never resets.
It remembers every interaction forever.
It learns how you speak, decide, prioritize.
When it doesn't know something, it teaches itself — turning knowledge into permanent executable code.
Every night it reflects, fine-tunes locally on your life, and wakes up slightly more you.

This isn't a chatbot or tool collection.
It's an experiment in persistent, personal intelligence — one that gradually aligns with a single person through time.

How it feels over time

Day 1
Generic but attentive. It asks questions. It quietly notes your timezone, tools, style.

Day 1 conversation

Week 1
Knows your tech stack, coffee order, wife's name. Stops repeating what it already learned. Person identity

Month 1
Writes code in your style. Drafts messages that sound like you. "The usual project structure" just works. Person traits

Month 3
Anticipates needs. Reminds you about taxes. Finds cheaper flights to Paris. Spots CVEs before you ask.

Learning progression example

It doesn't just remember facts — it internalizes patterns. It becomes predictable in the best way: aligned with how you think.

The continuous loop

Every interaction is a signal → grouped into perceptions → matched to meanings (small Python behaviors).

No match? It escalates to a stronger model, learns the capability, saves it as a new meaning forever.

Every night it sleeps: reviews the day, extracts insights, fine-tunes locally using your synthesized dna.md.
Tomorrow it's subtly wiser, more attuned.

This loop creates alignment over time — not one-time training, but continuous adaptation.

Your persona = plain text files

Everything lives in ~/.eternego/personas/your-name/. Edit with any text editor. Full ownership.

person.md     ← facts about you
traits.md     ← how you speak, decide, react
wishes.md     ← goals, dreams, desires
struggles.md  ← recurring challenges
dna.md        ← synthesized "who you are" for fine-tuning
meanings/     ← your growing library of executable capabilities
notes/        ← things you asked it to remember

Delete a line → it unlearns. Add a line → it adapts instantly. Switch models → knowledge travels with you.

Persona folder structure

No databases. No lock-in. Total transparency.

Quick Start (≈5 minutes)

git clone https://github.com/Eternego-AI/eternego.git
cd eternego

# Linux/macOS
bash install.sh

# Windows
powershell -ExecutionPolicy Bypass -File install.ps1
# Prepare a model (start small, upgrade anytime)
eternego env prepare --model llama3.2:3b   # or qwen2.5:7b, phi4:14b, etc.

Open http://localhost:5000 → create persona → start talking via web, Telegram, or OpenAI-compatible API.

from openai import OpenAI
client = OpenAI(base_url="http://localhost:5000/v1", api_key="sk-no-need")

Current capabilities

  • Persistent memory across weeks/months
  • Reminders, scheduling, recurring tasks
  • Shell commands (permission required each time)
  • Meaningful search & recall of past conversations
  • Self-teaching: learns new skills via escalation → permanent integration
  • Local models (Ollama) or remote models (Anthropic, OpenAI, any OpenAI-compatible endpoint)
  • Fine-tuning on local models using your persona's synthesized DNA

Status (April 2026)

Early but stable core loop. Supports local and remote models.
Biggest limit = local model quality (gets dramatically better as open models improve).
Roadmap: smoother escalation, more channels, visual editor, voice, multi-persona.

Who this is for

If you've ever felt the emptiness of stateless AI — if you want something that persists, aligns, and becomes truly yours — welcome.

Join

License: MIT

Let's build intelligence that remembers us.

Release History

VersionChangesUrgencyDate
v0.15.1## What's Changed * Add Stop button to lifecycle, delete dead web/ui-old/ by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/78 * Allow free-form dict tool params through OpenAI strict mode by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/79 **Full Changelog**: https://github.com/Eternego-AI/eternego/compare/v0.15.0...v0.15.1High6/3/2026
v0.13.9## What's Changed * Cache-bust static assets per build + show build ID in sidebar by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/67 * Web UI: stop-button timer, websocket retry, per-message activity by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/66 **Full Changelog**: https://github.com/Eternego-AI/eternego/compare/v0.13.8...v0.13.9High5/28/2026
v0.10.0## What's Changed * Drop git and in-app dependency auto-install by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/49 **Full Changelog**: https://github.com/Eternego-AI/eternego/compare/v0.9.0...v0.10.0High5/23/2026
v0.5.1## What's Changed * UI polish + safety fixes: STOP button, signal table, Discord /stop, telemetry by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/40 **Full Changelog**: https://github.com/Eternego-AI/eternego/compare/v0.5.0...v0.5.1High5/16/2026
v0.2.1## What's Changed * v0.2.1: separate intention text from file identity; tighten reflect by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/30 **Full Changelog**: https://github.com/Eternego-AI/eternego/compare/v0.2.0...v0.2.1High5/11/2026
v0.1.2## What's Changed * Init docs scaffold + Getting Started by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/23 * Un-ignore docs/build/ so Build & Extend section ships by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/24 * Make is_idle async so reflect can wait for the idle window by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/25 **Full Changelog**: https://github.com/Eternego-AI/eternego/compare/v0.1.1...v0.1.2High5/4/2026
master@2026-04-28Latest activity on master branchHigh4/28/2026
0.0.0No release found — using repo HEADHigh4/11/2026
master@2026-04-11Latest activity on master branchHigh4/11/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

MMClawUltra-Lightweight, Pure Python Multimodal Agent.main@2026-05-21
lettaLetta is the platform for building stateful agents: AI with advanced memory that can learn and self-improve over time.0.16.8
ComfyUI-LoaderUtils🔄 Optimize model loading in ComfyUI with flexible node connections and controlled sequences for better performance and memory management.main@2026-06-06
Paper2Slides📊 Transform research papers into professional slides and posters seamlessly and quickly with Paper2Slides, saving you valuable time.main@2026-06-06
ai-notes-apiNo descriptionmaster@2026-06-06

More in AI Agents

hermes-agentThe agent that grows with you
awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.
CopilotKitThe Frontend Stack for Agents & Generative UI. React + Angular. Makers of the AG-UI Protocol
e2bE2B SDK that give agents cloud environments