freshcrate
Skin:/
Home > AI Agents > eternego

eternego

The Eternego codebase

Why this rank:Release freshnessHealthy 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.18.0## What's Changed * Show a typing indicator while the persona thinks by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/91 * Ground intention so recognize stops drifting into duplicate meanings by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/93 * No-OS file converters + a name-lookup reflection helper by @MortezaPoussaneh in https://github.com/Eternego-AI/eternego/pull/92 * Add send — deliver a file to the person by @MortezaPoussaneh in https://github.com/EHigh6/9/2026
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-07-11
lettaLetta is the platform for building stateful agents: AI with advanced memory that can learn and self-improve over time.0.16.8
MaiBotMaiSaka, an LLM-based intelligent agent, is a digital lifeform devoted to understanding you and interacting in the style of a real human. She does not pursue perfection, nor does she seek efficiency; 1.1.0
autopoeA structured multi-agent framework for coordinated AI collaborationv0.3.10
LLM-Agent-Paper-dailyAutomatically Update LLM-Agent Papers Daily using Github Actions (Update Every 12th hours)main@2026-07-20

More in AI Agents

awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.
letta-codeThe memory-first coding agent
MiniSearchMinimalist web-searching platform with an AI assistant that runs directly from your browser. Uses WebLLM, Wllama and SearXNG. Demo: https://felladrin-minisearch.hf.space
tokentracker-cliToken usage tracker for AI agent CLIs (Claude Code, Codex, Cursor, Kiro, Gemini, OpenCode, OpenClaw, Hermes, GitHub Copilot)