Fava Investor安装与配置指南

1. 项目基础介绍

Fava Investor 是一个针对 Beancount 和 Fava（基于纯文本、双条目簿记软件）的全面投资报告、分析和工具集。该项目被设计为一个模块集合，每个模块都提供 Fava 插件、Beancount 库以及一个壳命令。

主要编程语言：Python

2. 项目使用的关键技术和框架

• Beancount: 一个基于文本的会计系统，使用 Python 进行解析和处理。
• Fava: 一个 Web 界面，用于查看 Beancount 数据文件。
• Click: 一个用于创建命令行界面的 Python 包。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已经安装了以下软件：

• Python 3.x（建议使用 Python 3.6 或更高版本）
• pip（Python 包管理器）

详细安装步骤

步骤 1：安装 Python 和 pip

如果您尚未安装 Python，请从 Python 官方网站下载并安装 Python。Python 安装完成后，pip 通常会自动安装。您可以通过在命令行中运行以下命令来检查 pip 是否已安装：

pip --version

如果未安装 pip，您可以按照 Python 官方网站上的指南进行安装。

步骤 2：安装 Fava Investor

通过 pip 安装 Fava Investor 的稳定版本：

pip3 install fava-investor

如果要安装最新的开发版本，可以使用以下命令：

pip3 install git+https://github.com/redstreet/fava_investor

步骤 3：配置 Beancount

为了在 Fava 中使用 Fava Investor，您需要在 Beancount 的源文件中添加一条自定义扩展配置。在 Beancount 文件的开头添加以下内容：

2000-01-01 custom "fava-extension" "fava_investor" "{}"

保存文件并启动 Fava，您应该在侧边栏中看到一个 'Investor' 链接。

步骤 4：使用命令行界面

Fava Investor 的命令行界面可以通过以下命令访问：

investor --help

每个模块都有自己的子命令。例如，要使用资产分配类模块，可以运行：

investor assetalloc-class

以上步骤应该能够帮助您成功安装和配置 Fava Investor。如果遇到任何问题，请查看项目的 README.md 文件或在相关社区寻求帮助。