Releases: Guts444/Lucky
Release list
Lucky v0.1.0
Lucky v0.1.0 — first public release
Local-first WinUI 3 AI agent harness for Windows.
Install (Windows x64)
Download one of the installers below:
| File | Description |
|---|---|
| Lucky-0.1.0-win-x64-Setup.exe | Recommended guided installer |
| Lucky-0.1.0-win-x64.msi | Windows Installer package (enterprise / silent deploy) |
Both install under Program Files, add Start Menu shortcuts, and include the Windows App SDK (self-contained).
Silent MSI:
msiexec /i Lucky-0.1.0-win-x64.msi /qnHighlights
- OpenRouter as a first-class provider
- DeepSeek, LM Studio, custom OpenAI-compatible, optional ChatGPT subscription
- Project-scoped file tools with visible Thinking traces
- Durable local memory, subagents, access levels
- Optional SearXNG, trusted page reader, stdio MCP, Docker sandbox
Notes
- Installers are currently unsigned (Windows SmartScreen may warn on first run — “More info → Run anyway”). Code signing can come in a later release.
- Full access PowerShell runs as your Windows user — not an OS sandbox.
- Report bugs on GitHub Issues. Security: see SECURITY.md.
MIT © Guts444
Lucky v0.1.0-preview
Lucky v0.1.0-preview
First public preview of Lucky — a local-first WinUI 3 AI agent harness for Windows.
This is an early, build-from-source release. APIs, UI, and packaging will still change before a stable v0.1.0. There is no polished installer yet.
Highlights
- WinUI 3 shell with project/history rail, streaming chat canvas, Thinking traces, and a rounded composer (model/reasoning, access level, context meter).
- Local-first state under
%LOCALAPPDATA%\Lucky— chats, projects, settings, and memories stay on your machine; API keys and MCP launch config use Windows DPAPI. - Providers: DeepSeek, LM Studio, custom OpenAI-compatible endpoints, and optional ChatGPT subscription models via a local app-server helper.
- Project file tools (Workspace / Full access): list, read, search, write, exact edit, unified-diff patch — path-safe and visible in the Thinking expander.
- Full access extras: bounded PowerShell at the project root, opt-in Docker code sandbox (no host mounts), trusted-domain page reader, stdio MCP tools.
- Durable memory with
USERprofile notes and project/sessionMEMORY, secret-skipping capture, lexical retrieval, and separate character budgets. - Subagents (
explorer,reviewer,tester,writer,worker+ custom JSON agents) with access caps and compact summaries back to the parent turn. - Access levels: Chat only → Workspace → Full access, enforced in the tool loop—not just the prompt.
- Optional web: user-controlled SearXNG (
/weband auto-search) plus opt-in static page reading.
Build from source
dotnet restore Lucky.slnx
dotnet build Lucky.slnx
dotnet test Lucky.slnx
dotnet run --project src\Lucky.App\Lucky.App.csproj -p:Platform=x64Requirements: Windows 10 1809+, .NET SDK matching the repo, Windows App SDK runtime. Optional: LM Studio, SearXNG, DeepSeek API key, ChatGPT plan + official local coding CLI, Docker Desktop for the sandbox.
Docs
- README — product overview and setup
- Architecture
- QA checklist
- Security policy
Known limitations
- Pre-release: expect breaking changes; no Store/MSIX release pipeline yet.
- MCP is stdio-only for now (no Streamable HTTP / OAuth MCP).
- Memory retrieval is lexical (not embeddings).
- Interactive browser automation requires a user-configured MCP server; Lucky’s built-in page reader is static and domain-trusted only.
- Full-access PowerShell is not an OS sandbox—treat it as running as you.
License
MIT © Guts444
Feedback and issues welcome on GitHub. Please report security issues privately per SECURITY.md — never open issues that include live API keys or chat logs.