---
name: Bug report
about: Something is broken or behaving unexpectedly
title: "bug: <short description>"
labels: ["bug"]
---

<!--
For security vulnerabilities, DO NOT open a public issue.
Email security@sovyx.ai — see SECURITY.md.
-->

## Description

<!-- What went wrong, in one or two sentences. -->

## Steps to reproduce

1.
2.
3.

## Expected behaviour

<!-- What you thought would happen. -->

## Actual behaviour

<!-- What actually happened. Paste the full error message, log line, or traceback. -->

```
<paste logs / traceback here>
```

## Environment

| | |
|---|---|
| Sovyx version | `sovyx --version` → |
| Install method | pip / uv / Docker / source |
| Python version | `python --version` → |
| OS | Linux / macOS / Windows / WSL — include the distro + version |
| Hardware tier | Pi 5 / N100 / desktop CPU / desktop GPU / cloud |
| LLM provider | anthropic / openai / google / ollama |

## Additional context

<!--
- Minimum config (mind.yaml snippet) that reproduces the bug.
- Relevant lines from ~/.sovyx/logs/sovyx.log (strip secrets first).
- Anything you already tried.
-->
