> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luminy.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Luminy: Agentic AI Coding Assistant for Developers

> Luminy turns any LLM into an active coding partner with direct access to your codebase, file system, and developer tools across 20+ AI providers.

Welcome to Luminy — a local-first desktop app that transforms any large language model into an active coding partner. Luminy gives your chosen AI direct access to your codebase, file system, shell, and git tooling, so it can read, write, search, and reason about your project just as a human collaborator would. Whether you prefer a private local model running entirely on your machine or a powerful cloud provider, Luminy keeps you in control.

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/quickstart">
    Install Luminy, connect a provider, and start chatting with your codebase in under 5 minutes.
  </Card>

  <Card title="Providers" icon="microchip" href="/providers/overview">
    Explore the 20+ supported AI providers, including local Ollama models and major cloud APIs.
  </Card>

  <Card title="Tools" icon="wrench" href="/tools/overview">
    Learn about the built-in agentic tools: file read/write, shell commands, git, and code search.
  </Card>

  <Card title="MCP Servers" icon="plug" href="/tools/mcp-servers">
    Extend Luminy with Model Context Protocol servers to connect any external data source or API.
  </Card>
</CardGroup>

## Getting up and running

You can go from a fresh install to a working AI coding session in three steps.

<Steps>
  <Step title="Download & Install">
    Visit [luminy.tech](https://luminy.tech) to grab the installer for your operating system — macOS, Windows, or Linux. Run the installer and launch Luminy; no additional runtimes or dependencies are required.
  </Step>

  <Step title="Add a project">
    Click the **+** button in the sidebar and select the root folder of any codebase on your machine. Luminy indexes your project using Tree-sitter so the AI can navigate and understand your code immediately.
  </Step>

  <Step title="Start chatting with your codebase">
    Type a question or task in the chat input — for example, *"Explain the architecture of this project"* — and watch Luminy's agentic loop explore your files, run searches, and produce a grounded, accurate answer.
  </Step>
</Steps>

<Note>
  Luminy is **local-first**: all your sessions, project data, and settings are stored locally on your own machine. Nothing is sent to Luminy's servers. The only outbound traffic is the requests you authorize to your chosen AI provider.
</Note>