Community¶

Join the Flock community! Connect with other developers, get help, and contribute to the project.

💬 Get Help & Connect¶

💡 Discussions

Ask questions, share ideas, and connect with the community.

GitHub Discussions
🐛 Issues

Report bugs, request features, and track development.

GitHub Issues
📦 PyPI

View releases, download packages, and check version history.

flock-core on PyPI
🔧 GitHub

Browse source code, fork the project, and submit pull requests.

GitHub Repository

🤝 How to Get Help¶

1. Search Documentation¶

Use the search bar (press / to focus) to find: - Installation instructions - API reference - Configuration options - Example code

2. Check Discussions¶

Before asking a question: - Search existing discussions - Browse the Q&A category - Look for similar issues

3. Ask the Community¶

If you can't find an answer: - Questions → Start a Discussion - Bug Reports → Open an Issue - Feature Requests → Open an Issue

🎯 Discussion Categories¶

💡 Q&A¶

Ask and answer questions about using Flock.

Popular topics: - Getting started - Agent design patterns - Performance optimization - Production deployment

📣 Announcements¶

Stay updated with release notes and project news.

What you'll find: - New feature announcements - Breaking changes - Security updates - Roadmap updates

💬 General¶

Discuss anything Flock-related.

Talk about: - Use cases and success stories - Architecture patterns - Integration ideas - Best practices

🌟 Show and Tell¶

Share what you've built with Flock!

Show us: - Your applications - Custom components - Example code - Benchmarks and comparisons

🐛 Reporting Issues¶

Bug Reports¶

Before reporting: 1. Search existing issues 2. Check if it's already fixed in latest version 3. Verify it's reproducible

Include in your report: - Flock version (pip show flock-core) - Python version (python --version) - Operating system - Minimal reproducible example - Expected vs actual behavior - Error messages and stack traces

Report a bug →

Feature Requests¶

Before requesting: 1. Check if it's already planned 2. Search existing feature requests 3. Consider if it fits Flock's philosophy

Include in your request: - Use case description - Proposed API or behavior - Alternative solutions you've considered - Why this matters to you

Request a feature →

🚀 Contributing¶

We welcome contributions of all kinds!

Ways to Contribute¶

Code contributions: - Fix bugs - Implement features - Improve performance - Add tests

Documentation: - Fix typos - Improve clarity - Add examples - Write guides

Community: - Answer questions - Review pull requests - Share your experience - Report issues

Getting Started¶

Fork the repository

git clone https://github.com/whiteducksoftware/flock.git
cd flock

Set up development environment

# Install with development dependencies
uv sync --dev --all-groups --all-extras

# Or with pip
pip install -e ".[dev]"

Run tests
```
pytest tests/
```
Make your changes
Follow existing code style
Add tests for new features
Update documentation
Run linters and formatters
Submit pull request
Describe your changes
Reference related issues
Ensure tests pass

See full contributing guide →

📜 Code of Conduct¶

We are committed to providing a welcoming and inclusive environment.

Our standards: - Be respectful and inclusive - Welcome newcomers - Give constructive feedback - Focus on what's best for the community

Enforcement: Unacceptable behavior may result in temporary or permanent ban from the community.

Read full Code of Conduct →

🎓 Resources¶

Learning Resources¶

Documentation - Official guides and reference
Examples - Working code samples
Blog Posts - Tutorials and insights

Project Resources¶

Changelog - Version history
Roadmap - Future plans
Architecture - Design philosophy

🏆 Contributors¶

Thank you to everyone who has contributed to Flock!

View all contributors →

Top Contributors¶

Your contributions make Flock better for everyone: - Bug fixes and features - Documentation improvements - Community support - Testing and feedback

📰 Stay Updated¶

Release Notes¶

Subscribe to releases on GitHub to get notified: - New features - Breaking changes - Bug fixes - Performance improvements

Watch releases →

Discussions¶

Follow discussions to stay in the loop: - Feature announcements - RFC (Request for Comments) - Community highlights - Roadmap updates

Follow discussions →

🌟 Recognition¶

Built with ❤️ by white duck GmbH

Technologies: - Python 3.10+ with modern async - OpenTelemetry for distributed tracing - DuckDB for analytics - React 19 for dashboard - Material for MkDocs for documentation

📞 Contact¶

For Users¶

Questions → GitHub Discussions
Bug Reports → GitHub Issues
Security Issues → Email security@whiteduck.de

For Business¶

Enterprise Support → Contact white duck GmbH
Consulting → Professional services available
Custom Development → Tailored solutions

⚖️ License¶

Flock is open source software licensed under the MIT License.

Join the conversation → GitHub Discussions