# How-to Guides

Practical guides to solve specific problems and tasks.

:::::{grid} 1 2 2 3
:gutter: 3

::::{grid-item}
:::{card} {octicon}`download;1.2em;sd-text-primary` Installation
:link: installation
:link-type: doc

Detailed guide on installing gmuse via various methods.
:::
::::

::::{grid-item}
:::{card} {octicon}`gear;1.2em;sd-text-primary` Configuration
:link: configuration
:link-type: doc

Set up API keys, customize prompts, and tune behavior.
:::
::::

::::{grid-item}
:::{card} {octicon}`terminal;1.2em;sd-text-primary` Shell Completions
:link: completions
:link-type: doc

Enable context-aware AI completions in your favorite shell.
:::
::::

::::{grid-item}
:::{card} {octicon}`bug;1.2em;sd-text-primary` Troubleshooting
:link: troubleshooting
:link-type: doc

Common errors, diagnostics, and debugging tips.
:::
::::

::::{grid-item}
:::{card} {octicon}`shield-lock;1.2em;sd-text-primary` Local Models
:link: local_models
:link-type: doc

Run a local LLM for maximum privacy.
:::
::::
:::::

```{toctree}
:maxdepth: 1
:hidden:

installation
configuration
completions
troubleshooting
local_models
```