Skip to main content

Community

Welcome to the Stepflow community! Whether you're looking for help, want to report a bug, or interested in contributing, this page will guide you to the right resources.

Getting Help​

GitHub Discussions​

The best place to ask questions, share ideas, and discuss Stepflow is GitHub Discussions.

Use Discussions for:

  • ❓ Questions about using Stepflow
  • 💡 Feature ideas and proposals
  • 🗣️ General discussions about workflows and architecture
  • 📢 Announcements and updates
  • 🎓 Sharing your Stepflow projects and use cases

Start a Discussion →

Documentation​

Our documentation is your first stop for learning about Stepflow:

Examples​

Check out our examples directory for real-world use cases:

  • Basic workflows
  • Custom Python components
  • Data pipelines
  • LangChain integration
  • OpenAI integration
  • Kubernetes batch processing
  • Production model serving

Reporting Issues​

Bug Reports​

Found a bug? Please report it on GitHub Issues.

Before creating an issue:

  1. Search existing issues to avoid duplicates
  2. Check if it's already fixed in the latest release
  3. Gather relevant information (version, OS, error messages)

When reporting a bug, include:

  • Clear description of the problem
  • Steps to reproduce
  • Expected vs actual behavior
  • Stepflow version (stepflow --version)
  • Operating system and environment details
  • Relevant logs or error messages
  • Minimal workflow example that demonstrates the issue

Report a Bug →

Security Issues​

If you discover a security vulnerability, please do not open a public issue. Instead, email the maintainers directly or use GitHub's private security reporting feature.

Feature Requests​

Have an idea for a new feature or improvement? We'd love to hear it!

Process:

  1. Check existing discussions to see if it's already proposed
  2. Start a new discussion in the "Ideas" category
  3. Describe your use case and why the feature would be valuable
  4. Engage with community feedback

Popular feature requests may be promoted to GitHub Issues for implementation tracking.

Propose a Feature →

Contributing​

We welcome contributions from everyone! Whether you're fixing a typo or implementing a major feature, your help is appreciated.

Types of Contributions​

  • 🐛 Bug fixes - Help us squash bugs
  • ✨ New features - Add functionality
  • 📝 Documentation - Improve docs and examples
  • 🧪 Tests - Increase code coverage
  • 🎨 Examples - Create new workflow examples
  • 🔍 Code review - Review pull requests

Getting Started​

  1. Read our Contributing Guide for development setup
  2. Check good first issues for beginner-friendly tasks
  3. Join the conversation in GitHub Discussions
Important

All contributors must sign the Individual Contributor License Agreement (ICLA) before their first contribution. Run python scripts/sign_icla.py in the repository.

Start Contributing →

Community Guidelines​

We are committed to providing a welcoming and inclusive environment for everyone.

Our Principles​

  • Be respectful - Treat everyone with respect and kindness
  • Be inclusive - Welcome people of all backgrounds and experience levels
  • Be constructive - Provide helpful feedback and assume good intentions
  • Be collaborative - Work together to solve problems
  • Be patient - Remember that everyone is learning

Expected Behavior​

  • Use welcoming and inclusive language
  • Respect differing viewpoints and experiences
  • Accept constructive criticism gracefully
  • Focus on what's best for the community
  • Show empathy towards other community members

Unacceptable Behavior​

  • Harassment, discrimination, or offensive comments
  • Personal attacks or trolling
  • Publishing others' private information
  • Spam or excessive self-promotion
  • Any conduct that could reasonably be considered inappropriate

If you experience or witness unacceptable behavior, please report it to the project maintainers.

Stay Connected​

GitHub​

Updates​

Social​

  • 🐦 Follow development updates on social media (coming soon)
  • 📧 Subscribe to our newsletter (coming soon)

Thank You​

Thank you for being part of the Stepflow community! Your participation, whether through questions, bug reports, feature ideas, or code contributions, helps make Stepflow better for everyone.

We look forward to seeing what you build with Stepflow! 🚀