1. 非技术 Serenata de Amor 行动速成课程
2. 技术 Serenata de Amor 行动速成课程
3. 通过代码和技术技能贡献
4. 支持
5. 更新
6. 致谢

非技术 Serenata de Amor 行动速成课程

什么

Serenata de Amor 是一个开放项目，利用人工智能对公共行政进行社会监督。

谁

我们是一群相信“权力属于人民”理念的人。我们也是 Open Knowledge Brasil 的 数据科学公民创新计划 的一部分。

在创始人和长期成员中，我们可以列出八位主要成员——以及来自开源和开放知识社区的众多贡献者：Tatiana Balachova、Felipe Cabral、Eduardo Cuducos、Irio Musskopf、Bruno Pazzim、Ana Schwendler、Jessica Temporal、Yasodara Córdova 和 Pedro Vilanova。

怎么样

与谷歌、Facebook 和 Netflix 等组织类似，我们利用技术跟踪政府支出，并使开放数据对所有人开放。我们最初关注巴西众议院的数据，后来扩展到联邦参议院和各市镇。

何时

Irio 在 2016 年初提出了该项目的主要想法。几个月来，他进行了试验，并召集了围绕该项目的人们。2016 年 9 月标志着我们首次众筹活动的启动。从那时起，我们一直在开发开源技术和工具，同时也在我们的 Facebook 和 Medium 上发布高质量的公民科技内容。

哪里

我们没有实体总部，但我们每天都在远程工作。我们的大多数想法都设计为可以在任何提供开放数据的国家使用，但我们的主要实施集中在巴西。

为什么

用数据赋能公民非常重要：人们谈论“智慧城市”、“监控”和“隐私”。我们更倾向于关注“智慧公民”、“问责制”和“开放知识”。

技术 Serenata de Amor 行动速成课程

什么

Serenata de Amor 开发开源工具，让人们更容易使用开放数据。重点是收集相关见解，并在易于访问的界面中分享这些信息。通过这个界面，我们邀请公民与政界人士、州政府和联邦政府就公共支出展开对话。

谁

Serenata 的核心角色由 Rosie 扮演：她是一种人工智能，负责分析巴西国会议员在任期间的开支。Rosie 可以发现可疑支出，并促使公民参与关于这些发现的讨论。她在推特上。

为了让人们能够可视化并理解 Rosie 生成的数据，我们创建了 Jarbas。在这个网站上，用户可以浏览国会议员的开支，并获取每项可疑支出的详细信息。这是验证一项怀疑的起点。

怎么样

我们在 GitHub 上有两个主要仓库。这是 主仓库，托管着 Rosie 和 Jarbas。此外，我们还有 toolbox——一个可以通过 pip 安装的软件包。另外，社区维护着一些实验性的 notebooks，以及我们的 静态网页。

何时

尽管所有这些组件协同工作，但工作的核心部分仍需不时手动执行。唯一始终在线的部分是 Jarbas——它全天候免费提供关于公共支出的广泛信息。

大约每月一次，我们会手动运行 Rosie 并更新 Jarbas。每年几次，我们会上传可通过 toolbox 访问的版本化数据集——但我们鼓励您在需要时使用 toolbox 生成最新的数据集。

哪里

Jarbas 运行在 Digital Ocean 的 droplets 上，并使用 Docker Cloud 架构进行部署。

为什么

对于大多数技术性“为什么”的问题，答案是我们过去就是这样做的，这让我们能够快速交付成果。我们承认这并不是最好的技术栈，但它确实把我们带到了今天。

通过代码和技术技能贡献

请确保您已阅读本页的“技术速成课程”。接下来，请查看我们的 贡献指南。

支持

• 加入我们在 Apoia.se 上的定期众筹活动 http://apoia.se/serenata
• 通过比特币向 1Gbvfjmjvur7qwbwNFdPSNDgx66KSdVB5b 捐款
• 在 Facebook 上关注、分享并互动
• 关注、转发并加入 Rosie 的推特，与您最喜欢的国会议员互动

更新

Serenata de Amor 行动已经扩展到新项目。因此，Rosie、Jarbas 以及整体基础设施的更新频率有所降低。如果您有经验，希望帮助我们更快地修复 bug 或提出改进建议，请加入我们的 Discord，一起讨论项目！另一方面，如果您正在寻找活跃的社区进行合作，我们诚邀您了解 Querido Diário 项目。

最后，如果您想了解更多关于 Serenata 当前状况的细节，可以查阅这篇葡萄牙语文章，该文章可在 Apoia.se 上找到。

致谢

Serenata de Amor 快速上手指南

Serenata de Amor 是一个利用人工智能监督公共行政支出的开源项目。其核心组件包括 Rosie（用于分析议员支出并识别可疑行为的 AI）和 Jarbas（用于展示数据和可疑支出的 Web 界面）。

注意：根据项目最新公告，该项目的核心基础设施更新频率已降低。如果您希望参与活跃的社区协作，建议关注其衍生项目 Querido Diário。本指南基于现有代码库提供基础运行方法。

环境准备

本项目主要使用 Python 开发，依赖 Docker 进行部分服务部署。

• 操作系统: Linux 或 macOS (Windows 用户建议使用 WSL2)
• Python: 3.6 或更高版本
• 包管理工具: pip
• 容器化: Docker 和 Docker Compose (用于运行 Jarbas 和数据库)
• 版本控制: Git

安装步骤

1. 克隆代码仓库

git clone https://github.com/okfn-brasil/serenata-de-amor.git
cd serenata-de-amor

2. 安装工具箱 (Toolbox)

Serenata 提供了一个名为 serenata-toolbox 的 Python 包，用于下载和处理数据集。

pip install serenata-toolbox

提示：国内用户若遇到 PyPI 下载缓慢，可使用清华源加速： pip install -i https://pypi.tuna.tsinghua.edu.cn/simple serenata-toolbox

3. 配置与数据获取

在使用 Rosie 进行分析前，需要获取巴西众议院或参议院的支出数据。使用 toolbox 下载数据（以下以众议院数据为例）：

serenata_toolbox.chamber_of_deputies.fetch_latest_dataset()
serenata_toolbox.chamber_of_deputies.clean()
serenata_toolbox.chamber_of_deputies.merge()

注：上述命令会在当前目录生成处理好的数据集文件。

4. 部署 Jarbas (Web 界面)

Jarbas 依赖于 Docker 来运行后端服务和数据库。确保 Docker 守护进程已启动，然后执行：

docker-compose up -d

这将启动 Web 服务器和数据库容器。首次运行可能需要几分钟拉取镜像。

基本使用

运行 Rosie 进行异常检测

Rosie 是核心的 AI 分析模块。在获取并处理好数据后，您可以手动触发 Rosie 来分析支出记录并生成“可疑支出”报告。

进入项目根目录，运行主要的分析脚本（具体脚本名称可能随版本略有变化，通常为 rosie 相关的入口）：

# 示例：运行 Rosie 的主分析流程
python -m rosie.main

说明：Rosie 会读取本地数据集，应用机器学习模型识别异常，并将结果输出到指定文件或数据库中供 Jarbas 调用。

访问 Jarbas 查看结果

当 Docker 容器正常运行且数据已更新后，您可以在浏览器中访问 Jarbas 界面来浏览议员支出和可疑记录：

http://localhost:8000

在界面中，您可以：

• 搜索特定的议员 (Congresspeople)。
• 查看具体的支出明细。
• 浏览由 Rosie 标记的可疑交易 (Suspicions)。

---

更多贡献细节和技术文档请参考项目仓库中的 CONTRIBUTING.md 及各子模块（rosie/, jarbas/）的 README 文件。