Lovelaice

A sovereign, local-first coding agent for the terminal. A native tool-calling ReAct loop (read/bash/write/edit/glob/list_dir), yolo by default. Three ways to run it:

One-shot — streams to stdout and exits: lovelaice "<prompt>" (piped stdin works too).
ACP server — lovelaice-acp speaks the official Agent Client Protocol v1 over stdio, so any ACP client (e.g. aegis, Zed) can drive lovelaice as a native, harness-free agent — local or direct-API models, no external CLI. Supports streaming, per-session MCP tools, token usage, and load_session resume. See know-how/acp-v1-server.md.
Library — lovelaice.agent.Agent / lovelaice.coding.create_coding_agent embed the engine directly.

Install

pipx install lovelaice

Configure

lovelaice --init writes a .lovelaice.py in the current directory. This file grounds the workspace: when you run lovelaice from any subdirectory, it walks up to the nearest .lovelaice.py and chdirs to its directory before running. Exactly one config grounds the workspace — there is no stacking.

Set OPENROUTER_API_KEY in your environment before running.

export OPENROUTER_API_KEY=sk-or-...
lovelaice

Commands and tools

The .lovelaice.py registers tools and commands as decorators on a Config object. Built-in tools: bash, read, write, edit, list, glob, grep, fetch. Add your own with @config.tool. See know-how/writing-a-tool.md and know-how/writing-a-command.md.

Thinking mode

Add thinking="high" (or "low"/"medium", or an integer token budget) on a model entry to enable OpenRouter's reasoning passthrough. Reasoning chunks render in a separate dim-italic panel above the agent's reply. Non-OpenRouter base URLs silently ignore the knob — v1 does not translate reasoning protocols across providers.

MCP

Pass mcp=[...] to Config(...) to spawn stdio MCP servers and register their tools. Tool names are prefixed mcp:<server>:<tool>.

config = Config(
    models=MODELS,
    prompt=PROMPT,
    mcp=[
        {"name": "filesystem", "command": "npx",
         "args": ["@modelcontextprotocol/server-filesystem", "."]},
    ],
)

License

MIT.

Metadata

Release files for lovelaice 2.13.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lovelaice 2.13.1
File	Size	Uploaded
lovelaice-2.13.1.tar.gz	197.3 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for lovelaice 2.13.1
File	Interpreter	ABI	Platform	Reset
lovelaice-2.13.1-py3-none-any.whl 56.4 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 253.6 kB

Release files / lovelaice-2.13.1.tar.gz

Download URL	lovelaice-2.13.1.tar.gz
Size	197.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`4f65a07e8b89e3741f83c5599c4c6cb74789eb66118ad7566cabbb2b0176ee84`
BLAKE2b-256 checksum How to use checksums	`297cf6aa13741e96729f8ba4f2349786cb5e813a9fc75575aa02fe90f7e87fcb`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / lovelaice-2.13.1-py3-none-any.whl

Download URL	lovelaice-2.13.1-py3-none-any.whl
Size	56.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2261309f6923ef5cf327f3fa29b965c3c8bceaf19a0b757339dbc1ae452a8b3f`
BLAKE2b-256 checksum How to use checksums	`d91281cc1435e5c18d6a0131716cc1d97786cb536713b8aadd78df419e6961cb`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`