explaingit

primaxlab/selfevolvingai

Analysis updated 2026-05-18

33PythonAudience · researcherComplexity · 4/5LicenseSetup · moderate

TLDR

A pure Python framework of 70 modules that simulates a self-evolving AI system through a perceive-reason-act-reflect loop.

Mindmap

mindmap
  root((SelfEvolvingAI))
    What it does
      70 module framework
      Perceive reason act loop
      Self improving code
    Tech stack
      Pure Python
      No dependencies
      AST code analysis
    Use cases
      Explore evolving AI ideas
      Study memory and reasoning modules
      Run evolution cycles
    Audience
      Researchers
      AI hobbyists
      Python developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run the interactive main.py loop to see how the 70 modules interact.

USE CASE 2

Trigger a manual evolution cycle and inspect the resulting generation state.

USE CASE 3

Study individual modules, like memory or metacognition, as standalone Python code.

USE CASE 4

Generate a status report showing which modules are active.

What is it built with?

Python

How does it compare?

primaxlab/selfevolvingai410979729/scope-recallarahim3/mlx-dspark
Stars333333
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity4/53/53/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

README is primarily in Chinese and the project is described as actively under development.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

SelfEvolvingAI is a Python framework described as a self-evolving AI system made up of 70 separate modules. The README is written primarily in Chinese. The project is marked as actively under development with APIs and functionality subject to change. The framework is organized around a loop: perceive inputs, recall from memory, reason about the problem, take action, reflect on what happened, and then update the system based on what was learned. Each stage in that loop is handled by dedicated modules. For example, memory is split into short-term, long-term, and episodic stores with forgetting curves. A self-improvement module analyzes its own code using Python's AST tools, detects issues, and attempts automatic fixes with version rollback available. A metacognition module evaluates confidence and detects gaps in the system's own knowledge. The 70 modules cover a wide range of AI-adjacent topics: knowledge graphs, causal reasoning, transfer learning, federated learning, reinforcement learning, prompt engineering, code generation, test automation, document generation, multimodal processing, defenses against adversarial attacks, vector storage, session management, a plugin system, stream processing, encryption, rate limiting, distributed locking, and internationalization, among others. The design principles listed in the README are: no external dependencies (pure Python only), each module works independently, all modifications must be reversible, changes are made in small increments rather than large rewrites, and all quality assessments use numeric scores. Running the system requires cloning the repository and calling main.py with one of several flags to run interactively, trigger an evolution cycle, view module status, or generate a report. The license is MIT.

Copy-paste prompts

Prompt 1
Explain what the perceive, memory, think, act, reflect, evolve loop in this README is describing in plain terms.
Prompt 2
Help me translate the Chinese module table in this README into an English reference doc.
Prompt 3
Show me how to call SelfEvolvingAI's process() and evolve() methods based on the code example in the README.
Prompt 4
Which of these 70 modules would be most useful to extract and reuse in a smaller Python project?

Frequently asked questions

What is selfevolvingai?

A pure Python framework of 70 modules that simulates a self-evolving AI system through a perceive-reason-act-reflect loop.

What language is selfevolvingai written in?

Mainly Python. The stack also includes Python.

What license does selfevolvingai use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is selfevolvingai to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is selfevolvingai for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.