finance-cli:基于 Python Streamlit + SQLite3 的个人记账 Web 应用项目

一个AI实现的基于python的Web记账应用

Branch1Tags0

📒 家庭记账本

基于 Python Streamlit + SQLite3 的个人记账 Web 应用,浏览器打开即用。

功能概览

  • 添加记录 — 表单填写金额、分类、日期、备注,点按钮提交
  • 查看记录 — 按月份和分类筛选,表格展示所有记录
  • 删除记录 — 输入记录 ID 即可删除
  • 分类统计 — 柱状图直观对比 + 统计表(含金额、笔数、占比)

环境要求

  • Python 3.10 及以上(内置 SQLite3,无需额外安装数据库)

快速开始

# 1. 进入项目目录
cd finance-cli

# 2. 安装依赖
pip install -r requirements.txt

# 3. 启动应用
streamlit run app.py

启动后浏览器会自动打开 http://localhost:8501。如果没有自动打开,手动访问该地址即可。

使用说明

应用左侧有侧边栏导航,点击切换三个页面:

📝 添加记录

  1. 填写金额(必须大于零)
  2. 选择分类(餐饮/交通/购物/娱乐/居住/其他)
  3. 选择日期(默认为今天)
  4. 备注选填
  5. 点击「✅ 添加记录」提交

提交成功后会显示记录 ID,表单自动清空。

📋 查看记录

  • 顶部两个下拉框:按月份、按分类筛选,默认"全部"
  • 中间表格展示匹配记录(ID、金额、分类、日期、备注、创建时间)
  • 底部删除区:输入要删除的记录 ID,点击删除即可

📊 分类统计

  • 柱状图:各分类消费总额对比
  • 统计明细表:每个分类的总金额、笔数、占比,最后一行是合计

数据存储

所有数据保存在 finance.db 文件中(SQLite 数据库),文件与代码同目录。该文件已加入 .gitignore,不会被提交到 Git。

如需备份数据,直接复制 finance.db 文件即可。

项目结构

finance-cli/
├── app.py              # Streamlit 页面与入口
├── database.py         # 数据库操作
├── config.py           # 预设分类与配置
├── requirements.txt    # Python 依赖
└── finance.db          # 数据库(自动生成)

Introduction

一个AI实现的基于python的Web记账应用

Customize your domain