---
name: Bug Report
about: Report a bug to help improve Cognithor
title: "[Bug] "
labels: bug
assignees: ''
---

<!-- Thanks for reporting! This template was inspired by @TomiWebPro's thorough Ubuntu testing. -->

## Environment

| Field | Value |
|-------|-------|
| **OS** | <!-- e.g., Windows 11 23H2, Ubuntu 24.04 LTS, macOS 15.2 --> |
| **Cognithor version** | <!-- run: cognithor --version  OR  python -c "import cognithor; print(cognithor.__version__)" --> |
| **Python version** | <!-- run: python3 --version --> |
| **Install method** | <!-- start_cognithor.bat / install.sh / bootstrap_windows.py / manual pip / Docker --> |
| **LLM backend** | <!-- Ollama / LM Studio / OpenAI / Anthropic / Gemini / Groq / DeepSeek / other --> |
| **Channel** | <!-- CLI / Web UI / Telegram / Discord / Slack / WhatsApp / Signal / Teams / Matrix / Voice / iMessage / Google Chat / Mattermost / Feishu / IRC / Twitch / REST API --> |

## Description

A clear and concise description of the bug.

## Steps to Reproduce

1. ...
2. ...
3. ...

## Expected Behavior

What you expected to happen.

## Actual Behavior

What actually happened. Include the exact error message if there is one.

## Logs

<details>
<summary>Click to expand log output</summary>

```
Paste relevant log output here.

Logs are located at:
  - Linux/macOS: ~/.cognithor/logs/cognithor.log
  - Windows: %USERPROFILE%\.cognithor\logs\cognithor.log

For install issues, paste the full terminal output.
```

</details>

## Screenshots

<!-- If applicable, add screenshots to help explain the problem. Especially useful for Web UI / Control Center issues. -->

## Additional Context

<!-- Any other context: config snippets, hardware details (GPU, VRAM), workarounds you tried. -->
