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
entonBuilds an autonomous AI robot with vision, voice, and decision-making capabilities using Python, PyTorch, and CUDA technology.main@2026-09-09
LLM-Agent-Paper-dailyAutomatically Update LLM-Agent Papers Daily using Github Actions (Update Every 12th hours)main@2026-09-07
daily_stock_analysisLLM驱动的 A/H/美股智能分析器:多数据源行情 + 实时新闻 + LLM决策仪表盘 + 多渠道推送,零成本定时运行,纯白嫖. LLM-powered stock analysis system for A/H/US markets.v3.32.0

More in AI Agents

CopilotKitThe Frontend Stack for Agents & Generative UI. React + Angular. Makers of the AG-UI Protocol
llm-for-zoteroA simple Zotero plugin that brings your own LLM into the side panel.
AIGC-Interview-Book【三年面试五年模拟】AIGC算法工程师面试秘籍。涵盖AIGC、LLM大模型、AI Agent、传统深度学习、自动驾驶、机器学习、计算机视觉、自然语言处理、强化学习、大数据挖掘、具身智能、元宇宙、AGI等AI行业面试笔试干货经验与核心知识。
a2a-sdkA2A Python SDK