Lovelaice
A sovereign, local-first coding agent for the terminal. Single ReAct loop over a small built-in tool set, yolo by default. Two modes:
- Interactive — full-screen Textual TUI:
lovelaice - One-shot — streams to stdout and exits:
lovelaice <prompt>
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lovelaice-2.8.0.tar.gz.
File metadata
- Download URL: lovelaice-2.8.0.tar.gz
- Upload date:
- Size: 186.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a38cd40c510e74ebf2cc228659af2587ebfeee8fa87044636ae32dce5fa540b1
|
|
| MD5 |
30235e91e163d218cbf0ce57a04624be
|
|
| BLAKE2b-256 |
a47ae4e71ade3c211eefcbe4c020d8077a3f013ae35d08395820536e69fa74bb
|
File details
Details for the file lovelaice-2.8.0-py3-none-any.whl.
File metadata
- Download URL: lovelaice-2.8.0-py3-none-any.whl
- Upload date:
- Size: 51.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3ceb8b0d8542adfd22eac4b376e4f688a0696e4d20f5ce9d4a62c139bb66c5f8
|
|
| MD5 |
e7c72cc2ed71d2baf1cbe3abfab12200
|
|
| BLAKE2b-256 |
62e9cc099220e65006239de640521fe95e2cd05a2ab522b496956672071f40f8
|
