## 核心功能
* **概念即影像**: 输入一个主题，Fogsight 将为您生成一部叙事完整的高水平动画，包含双语旁白与电影级的视觉质感。
* **智能编排**: Fogsight 的核心是其强大的LLM驱动的编排能力。从旁白、视觉元素到动态效果，AI 将自动完成整个创作流程，一气呵成。
* **语言用户界面 (LUI)**: 通过与 AI 的多轮对话，您可以对动画进行精准调优和迭代，直至达到您心中最理想的艺术效果。
## 快速上手
### 环境要求
* Python 3.9+
* 一个现代网络浏览器 (如 Chrome, Firefox, Edge)
* 大语言模型的 API 密钥。我们仅推荐您使用 Google Gemini 2.5。
### 安装与运行
1. **克隆代码仓库:**
```bash
git clone https://github.com/fogsightai/fogsight.git
cd fogsight
```
2. **安装依赖:**
```bash
pip install -r requirements.txt
```
3. **配置API密钥:**
```bash
cp demo-credentials.json credentials.json
# 复制 demo-credentials.json 文件并重命名为 credentials.json
# 编辑 credentials.json 文件，填入您的 API_KEY 和 BASE_URL。
# **请注意**，我们使用的是与 OpenAI 兼容的 SDK，但您仍应使用Gemini 2.5 pro
```
4. **一键启动:**
```bash
python start_fogsight.py
# 运行 start_fogsight.py 脚本
# 它将自动启动后端服务并在浏览器中自动打开 http://127.0.0.1:8000
```
5. **开始创作！**
在页面中输入一个主题（例如"冒泡排序"），然后等待结果生成。
### Docker 方式运行
如果您更喜欢使用 Docker，可以按照以下步骤：
1. **确保 Docker 已安装:**
请确保您的系统已安装 Docker 和 docker-compose。
2. **克隆代码仓库:**
```bash
git clone https://github.com/fogsightai/fogsight.git
cd fogsight
```
3. **配置API密钥:**
```bash
cp demo-credentials.json credentials.json
# 编辑 credentials.json 文件，填入您的 API_KEY、BASE_URL 和 MODEL
# 使用 OpenRouter 的配置示例：
# {
# "API_KEY": "sk-or-v1-您的OpenRouter密钥",
# "BASE_URL": "https://openrouter.ai/api/v1",
# "MODEL": "anthropic/claude-sonnet-4"
# }
# 使用 Gemini 的配置示例：
# {
# "API_KEY": "您的Gemini密钥",
# "BASE_URL": "",
# "MODEL": "gemini-2.5-pro"
# }
```
4. **使用 Docker Compose 启动:**
```bash
# 使用默认端口 8000
docker-compose up -d
# 或者指定自定义端口（例如 3000）
HOST_PORT=3000 docker-compose up -d
```
如果 Docker 镜像无法拉取，可以尝试使用代理，或者使用镜像的国内源。
5. **访问应用:**
打开浏览器访问 `http://localhost:8000`（或您指定的端口）
6. **停止服务:**
```bash
docker-compose down
```
## 联系我们/加入群聊
请访问[此链接](https://fogsightai.feishu.cn/wiki/WvODwyUr1iSAe0kEyKfcpqvynGc?from=from_copylink)联系我们或加入交流群。
## Contributors
### 高校
* [@taited](https://taited.github.io/) - 香港中文大学（深圳） 博士生
* [@yjydya](https://github.com/ydyjya) - 南洋理工大学 博士生
* [@zhichzhang](https://github.com/zhichzhang) - 南加州大学 硕士生
### WaytoAGI 社区
* [@richkatchen 陈财猫](https://okjk.co/enodyA) - WaytoAGI 社区成员
* [@shuyan-5200](https://github.com/shuyan-5200) - WaytoAGI 社区成员
* [@kk](https://okjk.co/zC8myE) - WaytoAGI 社区成员
### Index Future Lab
* [何淋 (@Lin he)](https://github.com/zerohe2001)
### AI 探索家
* [黄小刀 (@Xiaodao Huang)](https://okjk.co/CkFav6)
### 独立开发者与 AI 艺术家
* [@Lixin Cai 蔡李鑫](https://github.com/Lixin-Cai)
* [王如玥 (@Ruyue Wang)](https://github.com/Moonywang)
* [@Jack-the-Builder](https://github.com/Jack-the-Builder)
* [@xiayurain95](https://github.com/xiayurain95)
## 开源许可
本项目基于 MIT 许可证开源。
不过，如果您愿意在引用本项目时加上我们的署名与指向本项目的链接，我们会非常感谢 😊。
