Python bindings for ratatui — the high-performance Rust TUI engine, enabling expressive, responsive, and modern terminal applications. ⚡🐍
pyratatui is a single-repository open-source organization focused entirely on providing Python developers access to ratatui’s power. By combining Rust’s speed and Python’s accessibility, pyratatui allows developers to build terminal interfaces that are fast, reliable, and visually expressive. 🧠✨
- Deliver fully-typed, idiomatic Python bindings for ratatui 📚🐀
- Enable async-friendly, real-time terminal applications ⚡⏱️
- Provide composable widgets, layouts, and animation effects using TachyonFX 🎨🎞️
- Maintain high-quality documentation, examples, and developer guidance 📝📖
- Foster an inclusive, collaborative, and community-driven environment 🤝🌍
| Principle | Description |
|---|---|
| Clarity 🪞 | APIs are intuitive, consistent, and immediately understandable |
| Performance ⚡ | Leveraging ratatui’s Rust backend for high-speed, deterministic rendering |
| Reliability ✅ | CI/CD, testing, and reproducible packaging for production-grade stability |
| Documentation 📚 | Comprehensive tutorials, examples, and type hints for every feature |
| Community 💬 | Open collaboration, mentorship, and constructive feedback for contributors |
- Composable layout system: tables, lists, gauges, tabs, scrollbars, sparklines
- Advanced text styling: color, spans, modifiers, and alignment 🎨🖌️
- Animation & effects with TachyonFX 🎞️💫
- Async-enabled for real-time updates ⚡⏱️
- Typed Python APIs for IDE autocomplete and type safety 🐍📌
- PyPI-ready wheels and source distributions
- Typed stubs included for seamless developer experience
- CI/CD pipelines for quality and reproducibility
- Stabilize the public API and type hints ✅
- Expand widget library and layout primitives 🧩
- Enhance async runtime integrations ⚡
- Improve documentation, examples, and tutorials 📖
- Establish benchmarks and performance metrics 📊
- Incorporate community feedback for continuous evolution 💬🌱
All contributions are welcome — we value collaboration, improvement, and constructive engagement.
- Code & Features 🖥️: Bug fixes, performance improvements, new widgets
- Documentation & Examples 📝: Tutorials, usage examples, API clarity
- Community Support 💬: Answer questions, triage issues, provide feedback
Contributions are reviewed to maintain clarity, performance, and alignment with the project’s core principles.
- Repository: pyratatui
- Documentation: pyratatui Docs
- PyPI Package: pyratatui
- Issue Tracker: GitHub Issues
MIT License — free to use, modify, and redistribute.
pyratatui bridges Python and ratatui, enabling terminal applications that are efficient, expressive, and ergonomically designed. Our goal is to redefine terminal UIs as modern, interactive, and visually compelling, empowering developers to create next-generation command-line experiences. 🐀💨🎨⚡