项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-03 · 当前星标 ★ 1156
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 可执行 bash 的终端环境(用于一键安装或手动安装)
- Docker 与 Docker Compose(选择 Docker 方式部署时需要)
- 能访问 GitHub 与 whisper.money 的网络
- 用于访问 Web 界面的现代浏览器
安装与启动步骤
-
1一键安装脚本
执行官方安装脚本自动完成部署,官方推荐的快速上手方式,过程中需要联网。
bash <(curl -fsSL https://whisper.money/setup.sh) -
2访问应用
安装完成后在浏览器打开官方给出的本地域名即可进入 Whisper Money 界面。
-
3克隆仓库
手动安装的第一步,把项目代码下载到本地并进入项目目录。
git clone https://github.com/whisper-money/whisper-money.git cd whisper-money -
4运行安装命令
在项目目录内执行 whispermoney install,按提示完成手动安装流程。
whispermoney install -
5准备环境文件
使用 Docker 生产镜像前,先把生产环境配置模板复制为 .env 文件。
cp .env.production.example .env -
6启动 Docker 服务
用生产镜像后台启动全部服务,默认通过 8080 端口对外提供访问。
docker compose -f docker-compose.production.yml up -d -
7自定义端口启动
如需更换端口,在启动命令前设置 APP_PORT,例如改用 3000 端口。
APP_PORT=3000 docker compose -f docker-compose.production.yml up -d -
8Coolify 部署
在 Coolify 新建 Docker Compose 资源,选 Empty Compose File,粘贴官方 whisper-money.yaml 模板后部署。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
APP_PORT | 否 | Docker 生产镜像对外暴露的端口 | 3000 |
.env | 是 | Docker 部署使用的环境变量文件,由生产模板复制生成 | .env |
如何确认成功
脚本安装后访问 https://whisper.money.localhost;Docker 方式访问 http://localhost:8080 能看到应用界面。
常见问题
Q:安装完成后访问哪个地址?
A:一键脚本安装走 https://whisper.money.localhost;使用 Docker 生产镜像则默认走 http://localhost:8080。
Q:如何更换 Docker 启动端口?
A:在启动命令前加 APP_PORT,例如 APP_PORT=3000 docker compose -f docker-compose.production.yml up -d。
Q:怎么部署到 Coolify?
A:新建资源选择 Docker Compose,来源选 Empty Compose File,粘贴官方 whisper-money.yaml 模板内容后点 Deploy。
Q:数据库需要自己准备吗?
A:Coolify 模板已内置 MySQL 8.0(含健康检查)、持久化数据卷和自动生成的数据库凭据,无需手动搭建。
注意事项
- 官方推荐优先使用一键安装脚本,最省事。
- AI 功能可指向本地模型,将数据完全保留在自有基础设施上。
- Docker 生产镜像主要用于在本地验证生产部署效果。
核心亮点
- 数据完全自托管,财务隐私不经过第三方服务器
- 用结构化记账和图表替代 Excel 手工公式,减少维护成本
- 技术栈为 PHP + React,部署和二次开发门槛相对友好
不足之处
- 项目仍处成长阶段,功能深度和生态成熟度有待观察
- 自托管需要自行维护服务器和备份,对非技术用户有门槛
适用场景
- 个人日常记账与月度收支分析
- 家庭预算制定与执行跟踪
- 注重隐私的用户自建财务数据后台
替代项目
Firefly III、Actual Budget
上一篇:finance-agent
下一篇:easyread
同类项目推荐
maverick-mcp
开源
让 Claude 直接帮你查行情、跑回测、做个股分析
Stock market MCP server for Yahoo Finance data, technical analysis, portfolio tracki···
OpenBB
开源
一套接口打通多源金融数据,直接喂给量化与AI
Open Data Platform for analysts, quants and AI agents.
LibreTranslate
开源
自托管翻译 API,数据不出内网,离线也能翻
Free and Open Source Machine Translation API. Self-hosted, offline capable and easy ···
algo-trading-agent
开源
用 TypeScript 快速搭出自己的自动交易机器人
algo trade agent - bot, framework, API, indicator, book, course, community
OpenBB
开源
一个接口聚合全球金融数据,投研量化直接开跑
Open Data Platform for analysts, quants and AI agents.
scientific-agent-skills
开源
装个技能包,让 AI 助手秒变科研搭子
Turn any AI agent into an AI Scientist. The #1 Agent Skills library for science, use···
automatic-KG-creation-with-LLM
开源
用LLM自动从文本生成知识图谱,省去手工建模。
Automatic Ontology and Knowledge Graph construction with LLM
DeepSpot
开源
从病理切片直接预测基因表达,省去昂贵测序。
DeepSpot: Deep learning model for predicting spatial transcriptomics from H&E histop···
WorkMesh
开源
用 AI 智能体重塑招聘,让技能与岗位精准对接。
Open-source AI-era employment platform connecting skills, jobs, enterprises, governa···
