Skip to content

Welcome to the Cello Community¶

Built together, by developers, for developers

Cello is an open-source project that thrives on community contributions. Whether you are filing your first issue, answering a question on Discord, or submitting a Rust optimization -- every contribution matters. We are glad you are here.

Get Involved¶

  • Contributing

    Read the contributing guide to learn how to set up your development environment, submit pull requests, and follow our coding conventions.

    Contributing Guide

  • Code of Conduct

    We are committed to providing a welcoming, inclusive, and harassment-free experience for everyone. Please read and follow our code of conduct.

    Code of Conduct

  • Support

    Stuck on a problem? Browse common solutions, ask the community, or explore enterprise support options for production deployments.

    Get Support

  • Discord

    Real-time chat with the core team and other Cello developers. Get help, share projects, and stay up to date on announcements.

    Join Discord

How to Contribute¶

Contributing to Cello is straightforward. Follow these steps to go from zero to merged PR.

# Fork on GitHub, then clone your fork
git clone https://github.com/<your-username>/cello.git
cd cello

# Create a virtual environment
python -m venv .venv && source .venv/bin/activate

# Install development dependencies
pip install maturin pytest requests

# Build Rust extensions in development mode
maturin develop

# Run the test suite
pytest tests/ -v

# Run Rust checks
cargo clippy --all-targets
cargo fmt --check
cargo test

# Create a feature branch
git checkout -b feature/my-awesome-feature

# Make your changes, then verify
cargo clippy --all-targets
pytest tests/ -v

# Commit with a clear message
git add -A
git commit -m "feat: add awesome new feature"

# Push and open a pull request
git push origin feature/my-awesome-feature

Then open a Pull Request on GitHub. The CI pipeline will run automatically.

First-time contributor?

Look for issues labeled good first issue -- these are specifically curated for newcomers:

Good First Issues

Ways to Contribute¶

Not sure where to start? There are many ways to help beyond writing code.

Contribution Description Getting Started
Report Bugs Found something broken? File an issue with reproduction steps. Open a Bug Report
Request Features Have an idea for Cello? We would love to hear it. Open a Feature Request
Contribute Code Fix bugs, add features, or optimize Rust performance. Contributing Guide
Improve Docs Fix typos, add examples, clarify explanations. Edit on GitHub
Translate Help make the docs accessible in more languages. Discord #translations
Help Others Answer questions on Discord or Stack Overflow. Discord

Project Stats¶

  • Stars

    Show your support by starring the repository on GitHub.

    Star on GitHub

  • Forks

    Fork the project to start contributing or experiment with your own changes.

    Fork on GitHub

  • Contributors

    Join the growing list of developers who have contributed to Cello.

    View Contributors

  • Open Issues

    Browse open issues and help close them. Every fix counts.

    View Issues

Community Channels¶

Channel Best For Link
Discord Real-time help, announcements, casual chat Join Discord
GitHub Discussions Long-form questions, ideas, show-and-tell Discussions
Stack Overflow Searchable Q&A (tag: cello-framework) Stack Overflow
X / Twitter News, release announcements @CelloFramework
RSS Feed Automated release notifications Releases Feed

Acknowledgments¶

Cello is made possible by the work of these people and projects.

Core Contributors
  • Jagadeesh Katla -- Creator and lead maintainer
Technologies We Build On
Technology Role in Cello
Rust Core runtime and hot-path engine
PyO3 Python-Rust FFI bindings
Tokio Async runtime
Hyper HTTP/1.1 and HTTP/2 server
simd-json SIMD-accelerated JSON parsing
matchit Radix-tree routing
Inspiration

Cello stands on the shoulders of:

  • FastAPI -- Developer experience and type hints
  • Actix-web -- Rust performance patterns
  • Flask -- Simplicity and blueprints
  • Django -- Batteries-included philosophy

Ready to dive in?

The best way to join the community is to start building. Pick an example, read the getting started guide, or jump straight into the open issues.

Get Started Browse Issues