Open-source personal AI assistant and Agent Harness that plans tasks, runs tools and skills, and keeps memory across web and IM channels.
47.8K+125 this week10.4KPythonMITWell maintainedUpdated yesterday
NEDONION/lobster0
A self-hosted personal AI agent that chats with you and, after approval, carries out local tasks like file work, commands and scheduled jobs.
- Stars
- 103
- Forks
- 14
- Open issues
- 9
- Last commit
- 5 days ago
What is it?
Lobster0 is a self-hosted personal agent inspired by OpenClaw. It runs its core on your own machine and can be reached through a desktop app, a terminal UI, a web console, or chat channels such as Feishu, Telegram and Discord. All entry points share the same sessions, memory, permissions and audit records.
The agent calls a set of controlled tools for reading and writing files inside a configured workspace, running commands, fetching HTTPS pages, managing Markdown-based memory and driving a dedicated browser profile. The model can only propose tool calls; parameter validation, policy checks, approval, execution and logging are handled by the local core. Sensitive actions such as local writes or command execution show the exact command and wait for approval, and several permission modes control how much is confirmed automatically.
It also supports one-shot, interval and cron automation with budgets and pause/resume, and it works with any OpenAI-compatible model provider. Installation is via a Python wheel using uv; the project is at pre-release v0.7.0.
Key features
- 01Chat with OpenAI-compatible models, with streaming replies and tool calling
- 02Controlled file, command, HTTPS and memory tools with policy checks and approval
- 03Persistent Markdown memory indexed in SQLite, with review and forget
- 04Scheduled tasks: one-shot, interval and cron, with budgets and pause/resume
- 05Shared sessions across desktop, TUI, web console and Feishu, Telegram or Discord
Use cases
- Summarizing meeting notes or files in a local workspace into a weekly report
- Checking a Git repository for uncommitted changes with approved commands
- Running a daily scheduled summary of work done the previous day
- Controlling a personal agent from Feishu while the work runs on your own computer
Quick start
- 1
Install the v0.7.0 pre-release wheel with uv (download wheel and install)
curl -fL --proto '=https' --tlsv1.2 -o /tmp/lobster0_agent-0.7.0-py3-none-any.whl https://github.com/NEDONION/lobster0/releases/download/v0.7.0/lobster0_agent-0.7.0-py3-none-any.whl && uv tool install --python 3.12 "/tmp/lobster0_agent-0.7.0-py3-none-any.whl[feishu]" - 2
Configure model API key, Feishu credentials and owner interactively
lobster0 setup - 3
Start the Feishu gateway
lobster0 gateway
Things to know
- The v0.7.0 release is a pre-release and not a fully verified stable version.
- The one-line install script is not yet available and returns 404.
- Requires Python 3.12+ and uv; Feishu live verification is still pending.
- Needs an OpenAI-compatible model API key to work.
In collections
Topics
FAQ
- What is lobster0?
- A self-hosted personal AI agent that chats with you and, after approval, carries out local tasks like file work, commands and scheduled jobs. Lobster0 is a self-hosted personal agent inspired by OpenClaw. It runs its core on your own machine and can be reached through a desktop app, a terminal UI, a web console, or chat channels such as Feishu, Telegram and Discord. All entry points share the same sessions, memory, permissions and audit records.
- Is lobster0 free to use? What license does it have?
- lobster0 is open source under the MIT license. Check the license terms before using it in commercial products.
- Is lobster0 still maintained?
- Actively maintained. The last commit to lobster0 was on Nov 2, 2026.
- What can I use lobster0 for?
- Summarizing meeting notes or files in a local workspace into a weekly report Checking a Git repository for uncommitted changes with approved commands Running a daily scheduled summary of work done the previous day Controlling a personal agent from Feishu while the work runs on your own computer
- How do I install lobster0?
- Install the v0.7.0 pre-release wheel with uv (download wheel and install): curl -fL --proto '=https' --tlsv1.2 -o /tmp/lobster0_agent-0.7.0-py3-none-any.whl https://github.com/NEDONION/lobster0/releases/download/v0.7.0/lobster0_agent-0.7.0-py3-none-any.whl && uv tool install --python 3.12 "/tmp/lobster0_agent-0.7.0-py3-none-any.whl[feishu]" Configure model API key, Feishu credentials and owner interactively: lobster0 setup Start the Feishu gateway: lobster0 gateway
- Where can I get lobster0?
- The source code and installation instructions are on GitHub: https://github.com/NEDONION/lobster0
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Scripts and guides to run Hermes Agent, the 9Router model proxy and a Telegram bot gateway on your own Linux server or VM.
155+8 this week39ShellMITWell maintainedUpdated 15 days ago
A Rust-based personal AI agent runtime you run on your own machine, connecting LLM providers to chat channels, tools and hardware.
33.1K+72 this week5KRustApache-2.0Well maintainedUpdated 22 hours ago
A self-hosted personal AI assistant that runs on your machine or in the cloud and connects to chat apps like DingTalk, Lark, Discord and Telegram.
37.4K+406 this week3.3KPythonApache-2.0Updated yesterday
Leon is an open-source personal AI assistant that runs locally and can use tools, memory and context to complete tasks.
17.6K+24 this week1.5KTypeScriptMITWell maintainedUpdated yesterday
A self-hosted AI assistant for households and small teams, with multiple experts, IM channel integrations, and a web dashboard, all in one process.
11.7K+370 this week1.6KPythonMITWell maintainedUpdated yesterday