**Bug Description**
Clear description of the bug.

**To Reproduce**
Steps to reproduce:
1. Install OmniDaemon
2. Run this code...
3. See error

**Expected Behavior**
What you expected to happen.

**Actual Behavior**
What actually happened.

**Code Example**
```python
# Minimal reproducible example
from omnidaemon import OmniDaemonSDK

sdk = OmniDaemonSDK()
# Code that triggers bug...

Full error traceback here

[Create Bug Report →](https://github.com/omnirexflora-labs/OmniDaemon/issues/new)

---

## 💡 Feature Requests

### Suggesting Features

We love feature suggestions! Here's how to make a great request:

1. **Explain the problem** you're trying to solve
2. **Describe your proposed solution**
3. **Share your use case** - How would you use this?
4. **Consider alternatives** - Are there other ways to solve this?

### Feature Request Template

```markdown
**Problem**
Describe the problem you're trying to solve.

**Proposed Solution**
Your suggested implementation.

**Example**
```python
# How the API might look
await sdk.new_feature(...)

[Request Feature →](https://github.com/omnirexflora-labs/OmniDaemon/issues/new)

---

## 🤝 Contributing

Want to contribute to OmniDaemon?

- **Code contributions** - Bug fixes, features, tests
- **Documentation** - Improve docs, write tutorials
- **Community support** - Help others in Discussions
- **Share your projects** - Showcase what you built

**See:** [Contributing Guide](./contributing.md)

---

## 📰 Stay Updated

### GitHub

**Star the repo** to get updates: [omnirexflora-labs/OmniDaemon](https://github.com/omnirexflora-labs/OmniDaemon)

**Watch releases** to get notified of new versions.

### Social Media

- **X (Twitter):** [@abiorhmangana](https://x.com/abiorhmangana)
- **Website:** [mintify.com](https://mintify.com)

### Release Notes

Check [GitHub Releases](https://github.com/omnirexflora-labs/OmniDaemon/releases) for:
- New features
- Bug fixes
- Breaking changes
- Migration guides

---

## 🙏 Acknowledgments

### Core Team

- **[Abiola Adeshina](https://github.com/Abiorh001)** - Creator & Lead Maintainer

### Contributors

Thanks to all contributors who have helped make OmniDaemon better!

[View all contributors →](https://github.com/omnirexflora-labs/OmniDaemon/graphs/contributors)

### Open Source Projects

OmniDaemon is built on the shoulders of giants:

- **[FastAPI](https://fastapi.tiangolo.com/)** - Modern Python web framework
- **[Typer](https://typer.tiangolo.com/)** - CLI framework
- **[Rich](https://github.com/Textualize/rich)** - Beautiful terminal output
- **[Pydantic](https://pydantic.dev/)** - Data validation
- **[Redis](https://redis.io/)** - In-memory data store
- **[Python](https://python.org/)** - Programming language

---

## 📞 Contact

### General Inquiries

- **GitHub:** [@Abiorh001](https://github.com/Abiorh001)
- **X (Twitter):** [@abiorhmangana](https://x.com/abiorhmangana)
- **Website:** [mintify.com](https://mintify.com)

### Enterprise Sales

For enterprise support, custom integrations, or partnerships:

**Contact:** [mintify.com](https://mintify.com)

### Security Issues

**DO NOT** open public issues for security vulnerabilities.

**Report privately via GitHub:** [Security advisories](https://github.com/omnirexflora-labs/OmniDaemon/security/advisories/new)

Or email: [email protected]

---

## ❓ FAQ

### General

**Q: Is OmniDaemon free?**  
A: Yes! OmniDaemon is open source (MIT license). Enterprise support is available for purchase.

**Q: Which AI frameworks are supported?**  
A: All of them! OmniDaemon is framework-agnostic. Use OmniCore Agent, Google ADK, LangChain, CrewAI, or any Python callable.

**Q: Do I need Redis?**  
A: Redis is the default backend, but OmniDaemon is pluggable. Kafka, RabbitMQ, and other backends are on the roadmap.

**Q: Can I use OmniDaemon in production?**  
A: Absolutely! OmniDaemon is designed for production use with features like DLQ, retries, metrics, and horizontal scaling.

### Technical

**Q: How do I scale OmniDaemon?**  
A: Just run more agent runner processes. They automatically load balance via consumer groups.

**Q: How are failures handled?**  
A: Automatic retries with exponential backoff. After N retries, messages go to Dead Letter Queue (DLQ) for manual review.

**Q: Can I run multiple agents?**  
A: Yes! Register multiple agents in one runner, or run multiple runners with different agents.

**Q: How do I monitor agents?**  
A: Use `omnidaemon health`, `omnidaemon metrics`, and `omnidaemon bus` commands. Prometheus integration coming soon.

### Troubleshooting

**Q: Agent not receiving messages?**  
A: Check consumer group with `omnidaemon bus groups --topic your.topic`

**Q: High memory usage?**  
A: Reduce `OMNIDAEMON_DEFAULT_MAXLEN` to limit stream size.

**Q: Messages in DLQ?**  
A: Check with `omnidaemon bus dlq --topic your.topic` and inspect errors.

**See full troubleshooting:** [README Troubleshooting](https://github.com/omnirexflora-labs/OmniDaemon/blob/main/README.md#troubleshooting)

---

## 🎯 Community Guidelines

### Be Respectful

- Treat everyone with respect
- Be welcoming to newcomers
- Accept constructive criticism gracefully
- Focus on what's best for the community

### Be Helpful

- Answer questions when you can
- Share your knowledge
- Provide code examples
- Point to relevant documentation

### Be Professional

- No spam or self-promotion
- Stay on topic
- No trolling or harassment
- Keep discussions productive

---

**Thank you for being part of the OmniDaemon community!** 🚀

**Questions?** [Ask on GitHub Discussions](https://github.com/omnirexflora-labs/OmniDaemon/discussions)