Dara 应用框架使用教程

Dara 应用框架使用教程

dara Dara is a dynamic application framework designed for creating interactive web apps with ease, all in pure Python. 项目地址: https://gitcode.com/gh_mirrors/da/dara

1. 项目介绍

Dara 是一个动态应用框架，专为创建交互式 Web 应用而设计，所有功能均使用纯 Python 实现。Dara 在过去两年中推动了数百个应用的开发，现在被广泛使用并受到客户和内部团队的赞赏。

2. 项目快速启动

安装 Dara CLI 工具

首先，您需要安装 create-dara-app CLI 工具来创建一个新的 Dara 应用。您可以使用 pip 或 pipx 来安装：

pip install create-dara-app

或者使用 pipx：

pipx install create-dara-app

创建新应用

安装完成后，运行以下命令来创建一个新的 Dara 应用：

create-dara-app

默认情况下，CLI 工具会尝试使用 poetry 来搭建项目，但如果 poetry 不存在，则会回退到 pip。您可以使用 --packaging pip 或 --packaging poetry 标志来覆盖默认设置。

运行应用

项目创建完成后，您可以进入项目目录并运行应用：

cd my-dara-app

# 使用 poetry 安装
poetry run dara start

# 使用 pip 安装
# 确保激活新的虚拟环境
source venv/bin/activate
dara start

注意：使用 pip 安装时，需要 pip >= 21.3 和 setuptools >= 64.0.0。您可以通过以下命令升级：

python -m pip install --upgrade pip
pip install --user --upgrade setuptools

3. 应用案例和最佳实践

应用案例

Dara 提供了多个应用案例，帮助您快速上手并了解框架的使用：

• LLM Chat Box 应用：展示如何将 LLM 聊天框集成到决策应用中，以理解模型洞察。
• 交互式图表应用：展示如何使用 Bokeh 或 Plotly 图表与用户交互，触发基于点击、鼠标移动等操作的动作。
• 因果图查看器应用：展示如何使用 CausalGraphViewer 组件显示图表或网络，并通过颜色和工具提示自定义显示信息，并根据用户交互更新页面。

最佳实践

• 使用 poetry 管理依赖：推荐使用 poetry 来管理项目依赖，以确保环境的一致性和可重复性。
• 模块化设计：将应用拆分为多个模块，每个模块负责特定的功能，便于维护和扩展。
• 使用 Dara 组件库：充分利用 Dara 提供的组件库，减少重复开发，提高开发效率。

4. 典型生态项目

Dara 生态系统包含多个核心项目，以下是一些典型的生态项目：

• dara-core：Dara 框架的核心，包含创建应用的核心框架代码。
• dara-components：Dara 框架的组件库，提供丰富的 UI 组件。
• create-dara-app：用于创建新 Dara 应用的 CLI 工具。

这些项目共同构成了 Dara 应用框架的完整生态系统，帮助开发者快速构建和部署交互式 Web 应用。

dara Dara is a dynamic application framework designed for creating interactive web apps with ease, all in pure Python. 项目地址: https://gitcode.com/gh_mirrors/da/dara