《Tenki 项目安装与配置指南》

1. 项目基础介绍

Tenki 是一个开源项目，主要用于天气预报信息的展示。它允许用户通过简单的界面查看当前的天气状况和未来几天的天气预报。该项目主要使用 Python 编程语言实现。

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

• 编程语言：Python
• 前端框架：使用 Flask 作为 Web 框架
• 数据获取：利用 OpenWeatherMap API 获取天气数据
• 后端数据库：使用 SQLite 存储配置信息和缓存数据

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

• 确保你的操作系统为 Windows、macOS 或 Linux
• 安装 Python 3.8 或更高版本
• 安装 Git 用于克隆项目仓库
• 安装虚拟环境管理工具（如 virtualenv）

安装步骤

第一步：克隆项目仓库

打开命令行工具（在 Windows 中可以使用 PowerShell 或 CMD），执行以下命令克隆项目：

git clone https://github.com/ckaznable/tenki.git

第二步：设置虚拟环境

进入项目目录，创建并激活虚拟环境：

cd tenki
python -m venv venv
source venv/bin/activate  # 在 Windows 中使用 `venv\Scripts\activate`

第三步：安装项目依赖

在虚拟环境激活的状态下，安装项目所需的依赖：

pip install -r requirements.txt

第四步：配置项目

在项目目录中，创建一个名为 .env 的文件，并填入以下内容（替换 <your_api_key> 为你的 OpenWeatherMap API 密钥）：

OPENWEATHER_API_KEY=<your_api_key>

第五步：运行项目

在命令行中执行以下命令启动 Flask 服务：

python run.py

项目将启动并在默认的 Web 服务器（通常是 http://127.0.0.1:5000/ 或 http://localhost:5000/）上运行。

注意事项

• 确保你的网络环境可以访问 OpenWeatherMap 的服务。
• 如果遇到任何问题，可以查看项目的 README.md 文件或者通过项目的 GitHub Issues 页面寻求帮助。

通过以上步骤，你应该能够成功安装和配置 Tenki 项目，并开始使用它来查看天气预报信息。