<p align="center">
<img src="https://yellow-cdn.veclightyear.com/835a84d5/ceef119f-2079-4343-9e21-928d7dccfbcd.svg?raw=true" alt="Rio标志" style="width: 100%; height: 9rem"/>
</p>
<p align="center">
<strong>Rio</strong>是一个易于使用的网站和应用程序创建框架，<strong>完全基于Python</strong>。🐍
<br>
你<strong>无需编写任何HTML、CSS或JavaScript代码</strong>就能创建美观、现代的应用程序。<br><br>
<a href="https://rio.dev/get-started?s=pl1">教程</a> - <a href="https://rio.dev/examples?s=g8r">示例</a> - <a href="https://discord.gg/7ejXaPwhyH">Discord</a> - <a href="https://rio.dev/docs?s=o1z">文档</a> - <a href="https://github.com/rio-labs/rio">源代码</a><br><br>
Rio将React风格的组件引入Python。你可以从丰富的内置组件中选择，并将它们组合以创建自定义组件。然后将这些组件组合成完整的应用程序。最棒的是，Rio应用程序既可以在本地机器上运行，也可以在网络上运行。
</p>
<p align="center">
<img src="https://yellow-cdn.veclightyear.com/835a84d5/752431c6-199e-4c01-ba0d-590a867fff76.svg?color=%2311e8e3e&link=https%3A%2F%2Frio.dev&style=flat-square&logo=data:image/svg%2bxml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxzdmcKICAgd2lkdGg9IjEwMDIuMTA1IgogICBoZWlnaHQ9IjE0OTkuODA1NyIKICAgdmlld0JveD0iMCAwIDI2NS4xNDAyOSAzOTYuODIzNTkiCiAgIHZlcnNpb249IjEuMSIKICAgaWQ9InN2Zzg5NiIKICAgeG1sOnNwYWNlPSJwcmVzZXJ2ZSIKICAgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIgogICB4bWxuczpzdmc9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIgogICB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiCiAgIHhtbG5zOmNjPSJodHRwOi8vY3JlYXRpdmVjb21tb25zLm9yZy9ucyMiCiAgIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyI+PGRlZnMKICAgICBpZD0iZGVmczg5MCIgLz48bWV0YWRhdGEKICAgICBpZD0ibWV0YWRhdGE4OTMiPjxyZGY6UkRGPjxjYzpXb3JrCiAgICAgICAgIHJkZjphYm91dD0iIj48ZGM6Zm9ybWF0PmltYWdlL3N2Zyt4bWw8L2RjOmZvcm1hdD48ZGM6dHlwZQogICAgICAgICAgIHJkZjpyZXNvdXJjZT0iaHR0cDovL3B1cmwub3JnL2RjL2RjbWl0eXBlL1N0aWxsSW1hZ2UiIC8+PC9jYzpXb3JrPjwvcmRmOlJERj48L21ldGFkYXRhPjxnCiAgICAgaWQ9ImxheWVyMSIKICAgICB0cmFuc2Zvcm09InRyYW5zbGF0ZSgyNi40MTM4NDcsNTAuMjcxMzUpIj48cGF0aAogICAgICAgaWQ9InBhdGgxIgogICAgICAgc3R5bGU9ImZpbGw6I2ZmZmZmZjtmaWxsLW9wYWNpdHk6MTtzdHJva2Utd2lkdGg6MC4yNjQ1ODMiCiAgICAgICBkPSJtIC04LjgwMzA4MDMsLTUwLjI3MTM1IGMgLTE1LjI3NjU1OTcsMC44NjA1MjQgLTE4LjYzMTgzNDcsMTcuNTQ0NTEyIC0xNy4zNjc0MTU3LDI5Ljk2ODk1MiAwLjUxMzcyNywxNi4yNDQxNjYxIC0xLjIxMzE5NywzMi43MTkyOTcgMS4yNjg1MTcsNDguNzY2NzkzIDguMTQxMTg1LDE0LjcxMDAxMiAyNi4wNzc2NzYxLDE4Ljg0OTk3MiAzOS44Nzc0ODIsMjYuNzcwMTM0IDMwLjM3ODk2MiwxNS4wNjY1NSA2MC43NTc5MjUsMzAuMTMzMTAxIDkxLjEzNjg4Nyw0NS4xOTk2NTEgLTM0LjgyMjM5OCwxNy42MDY2OCAtNzAuMjI2MTE3LDM0LjE0NzgzIC0xMDQuNjYwNTA2OCw1Mi40NjUyOCAtMjAuMDM3Nzc1MiwxMS40ODE0NCAtMzQuNzc4MTg3MiwzNi45NjY5OCAtMjQuMTAxMTk2Miw1OS41OTIxMSAxMS4yOTkzMSwyNS42MDQ3IDM5Ljc0MjkxMSwzMy43MTY5NSA2Mi40NzIyMDgsNDUuOTY4MDIgNTguOTU5MTAzLDI5LjA5NDExIDExNy43MTA1MzUsNTguNjQ4NDIgMTc2Ljc4OTE1NSw4Ny40NzU2IDE0LjA2MTIxLDMuOTY4MzYgMjQuMDM2NzYsLTEyLjAyMzEgMjEuODAwNzksLTI0LjUzMjIgLTAuNTQyODUsLTE3LjgzMTU3IDEuMjU4MTYsLTM1LjkwMjkyIC0xLjI2ODM2LC01My41MzY0OCAtOC4xNDA2MywtMTQuNzEwNzEgLTI2LjA3NjkyLC0xOC44NTE5OCAtMzkuODc3MTksLTI2Ljc3MTcyIC0zMC4zNzYwNiwtMTUuMDcxMTUgLTYwLjgwMDczLC0zMC4xNDExNyAtOTEuMTQ2NDIsLTQ1LjIxMzA0IDM0LjUwODc5LC0xNy4zNzM3NyA2OS40NTU5NywtMzMuOTI1NjUgMTAzLjY3Mjk4LC01MS44NDY2MyAyMC4xOTUxMywtMTEuMDA2MjggMzUuMzg2NDQsLTM2LjMwMDA1IDI1LjYwMzM4LC01OC45ODA5NCBDIDIyNC43MDYyMyw1OC44NzI1MzQgMTk2LjA1MDY3LDUwLjQ4NjY0MSAxNzMuMTY3MjYsMzguMjM4MTkxIDE1MS4xOTIyNiwyNy4zNDkyOTUgMTI2LjI0NjM5LDE0LjkzOTYzOCAxMDYuMTIxMTcsNC45OTc2Mjc4IDcwLjA0MTcxOSwtMTIuODk5Mjk5IDMzLjk2MjI2OCwtMzAuNzk2MjI1IC0yLjExNzE4MzQsLTQ4LjY5MzE1MiBsIC0zLjM3MjY3NzcsLTEuMjE4NDkyIHoiIC8+PC9nPjwvc3ZnPgo=" alt="Rio"/>
<img src="https://img.shields.io/pypi/v/rio-ui?color=%2311e8e3e&style=flat-square" alt="版本"/>
<!--
<img src="https://img.shields.io/discord/1213589765484576818?color=%2311e8e3e&label=discord&style=flat-square" alt="Discord"/>
-->
<img src="https://img.shields.io/pypi/pyversions/rio-ui?style=flat-square" alt="Python版本"/>
<img src="https://img.shields.io/pypi/l/rio-ui?color=%2311e8e3e&style=flat-square" alt="许可证"/>
<img src="https://img.shields.io/github/stars/rio-labs/rio?style=flat-square" alt="GitHub星标"/>
<img src="https://img.shields.io/pypi/dm/rio-ui?color=%2311e8e3e&style=flat-square" alt="下载量"/>
</p>
特性 🧩
- 现代化的声明式UI框架
- 100% Python - 无需HTML、CSS或JavaScript
- 超过50个内置组件用于常见UI元素，如
rio.Switch、rio.Button和rio.Text等
- 与现代Python工具集成：由于完全类型安全，编辑器可以立即给出建议并突出显示问题
- 应用程序可以在本地和网络上运行
- 内置开发工具
- 开源且永久免费
示例 ⌨️
# 定义一个计算按钮点击次数的组件
class ButtonClicker(rio.Component):
# 定义组件的属性。Rio会监视这些属性的变化
# 并自动更新GUI。
clicks: int = 0
# 定义一个增加点击次数的方法。我们稍后会创建一个按钮，每次按下时都会调用这个方法。
def _on_press(self) -> None:
self.clicks += 1
# 定义`build`方法。这个方法本质上告诉rio
# ButtonClicker组件的外观。每当ButtonClicker组件的状态
# 发生变化时，rio都会调用其`build`方法并根据输出更新GUI。
def build(self) -> rio.Component:
return rio.Column(
rio.Button('点击我', on_press=self._on_press),
rio.Text(f'你点击了按钮 {self.clicks} 次'),
)
# 创建一个App并告诉它在启动时显示ButtonClicker
app = rio.App(build=ButtonClicker)
app.run_in_browser() # 或者使用`app.run_in_window()`作为本地应用运行！
安装 🛠️
Rio可以在PyPI上获取，所以你可以使用pip安装：
pip install rio-ui
快速开始 🎓
Rio提供了一个非常有用的命令行工具来帮助你。只需一个简短的命令就可以创建新项目：
rio new
你可以从各种内置模板中选择来开始。这里是一个基于井字游戏模板创建项目的完整示例：
rio new my-project --type website --template "Tic-Tac-Toe"
cd my-project
rio run
几秒钟内你就能运行起你的第一个应用了！
状态：开发中 🚧
Rio仍在开发中。我们正在努力为你带来最好的体验。如果你有任何反馈，请在我们的Discord服务器上告诉我们。
贡献 🤝
每个项目都因帮助而蓬勃发展，Rio也不例外。有很多方式可以参与进来，比如添加新功能、修复bug，或者只是分享你的想法。向项目提交Pull Request时，请查看我们的贡献指南。Rio每周都在推出新功能，不断变得更好。给这个仓库加星⭐并👀关注，以保持最新动态！
除非你明确声明，否则提交用于包含在Rio中的任何贡献都将根据Apache-2.0许可证的条款进行许可，不附加任何额外条款或条件。
社区支持 🫶
加入Rio冒险，成为一个很棒的团队的一部分！以下是联系方式：
- Discord（提升你的Rio技能！加入我们的Discord服务器与其他开发者聊天，讨论如何贡献。）
- GitHub（**发现bug？**Issues是让我们知道的完美地方。想更进一步帮忙？尝试修复现有issue并提交PR！）
- 社区论坛（加入我们在Github上的社区论坛提问和讨论）
- 功能请求（在GitHub上请求功能的最清晰方式）
关于使用Rio的一般帮助，请参考Rio官方文档。
