---
name: Bug Report
about: Report a bug or issue with Nexus
title: '[BUG] '
labels: ['bug']
assignees: ''
---

## Bug Description

A clear and concise description of what the bug is.

## Steps To Reproduce

1. Go to '...'
2. Execute '...'
3. See error

**Minimal Reproducible Example:**

```python
# Paste a minimal code example that reproduces the issue
import nexus

# Your code here
```

## Expected Behavior

A clear and concise description of what you expected to happen.

## Actual Behavior

What actually happened?

## Environment

- **Nexus Version:** [e.g., 0.1.0]
- **Python Version:** [e.g., 3.14.1]
- **OS:** [e.g., macOS 14.0, Ubuntu 22.04, Windows 11]
- **Deployment Mode:** [embedded/monolithic/distributed]
- **Installation Method:** [pip/uv/source]

## Error Messages

```
Paste any relevant error messages, stack traces, or logs here
```

## Additional Context

- [ ] I have searched existing issues to ensure this hasn't been reported before
- [ ] I have read the [documentation](https://github.com/nexi-lab/nexus/blob/main/README.md)
- [ ] I can consistently reproduce this issue

Add any other context about the problem here (screenshots, configuration files, etc.).

## Possible Solution

If you have suggestions on how to fix this issue, please share them here.
