Skip to content

Releases: Guts444/Lucky

Lucky v0.1.0

Choose a tag to compare

@Guts444 Guts444 released this 12 Jul 23:23

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 /qn

Highlights

  • 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 Pre-release
Pre-release

Choose a tag to compare

@Guts444 Guts444 released this 12 Jul 22:48

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 USER profile notes and project/session MEMORY, 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 (/web and 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=x64

Requirements: 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

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.