← all repositories
lsdefine/GenericAgent

A 3,000-line seed that grows its own skill tree

GenericAgent is a minimal framework that lets any LLM bootstrap itself into a full system operator by turning every solved task into a reusable skill.

GenericAgent
Velocity · 7d
+13
★ / day
Trend
cooling
star history

What it does

GenericAgent is a Python framework that gives supported LLMs direct control over a local computer—browser, terminal, filesystem, keyboard, mouse, screen vision, and mobile devices via ADB. Its core is roughly 3,000 lines of code built around nine atomic tools and a ~100-line execution loop. The agent handles tasks by perceiving the environment, reasoning, executing tools, and writing what it learned into memory.

The interesting bit

Rather than preloading capabilities, the framework “crystallizes” each completed task into a reusable Skill stored across a five-layer memory stack. The authors claim the repository itself serves as a self-bootstrap proof, asserting that every commit from git init onward was generated without the author opening a terminal. It also claims to operate on under a 30K token context window, which it says is a fraction of the 200K–1M windows other agents consume.

Key highlights

  • Accumulates a personal skill tree over time; the longer it runs, the more capable it becomes without manual dependency hunting.
  • Injects into a real browser with session persistence, not a headless sandbox, alongside OS-level input and screen access.
  • Supports multiple LLM backends including Claude, Gemini, Kimi, and MiniMax.
  • Ships with desktop, terminal, Streamlit, and instant-messenger frontends covering Telegram, WeChat, Lark, and others.
  • Can dynamically extend its own toolset at runtime by writing and executing code, then promoting useful scripts into permanent skills.

Caveats

  • Python 3.14 is explicitly incompatible due to pywebview dependency issues; the project targets Python 3.11 and 3.12.
  • The Textual-based terminal UI can render poorly on Windows depending on the terminal emulator and font.
  • The comparison table in the README is truncated, so several claimed distinctions against other tools are incomplete in the provided source.

Verdict

Worth exploring if you want an agent that accumulates bespoke competence over time rather than starting from scratch each session. Less appealing if you prefer exhaustive human-readable documentation over a tool that literally expects you to ask it for help with its own configuration.

Frequently asked

What is lsdefine/GenericAgent?
GenericAgent is a minimal framework that lets any LLM bootstrap itself into a full system operator by turning every solved task into a reusable skill.
Is GenericAgent open source?
Yes — lsdefine/GenericAgent is open source, released under the MIT license.
What language is GenericAgent written in?
lsdefine/GenericAgent is primarily written in Python.
How popular is GenericAgent?
lsdefine/GenericAgent has 13.5k stars on GitHub and is currently cooling off.
Where can I find GenericAgent?
lsdefine/GenericAgent is on GitHub at https://github.com/lsdefine/GenericAgent.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.