InterviewPilot

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 10 Open GitHub ↗

把“简历 + 面试录屏 + 知识库”转成可执行复盘结果：真实问答、分析报告、模拟面试。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# InterviewPilot（面试复盘助手）

[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://raw.githubusercontent.com/wind127/InterviewPilot/main/LICENSE)
[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white)](https://raw.githubusercontent.com/wind127/InterviewPilot/main/apps/api)
[![Node](https://img.shields.io/badge/Node-20%2B-339933?logo=nodedotjs&logoColor=white)](https://raw.githubusercontent.com/wind127/InterviewPilot/main/apps/web)
[![Docker Ready](https://img.shields.io/badge/deploy-docker-blue?logo=docker)](https://raw.githubusercontent.com/wind127/InterviewPilot/main/docker-compose.yml)

把“简历 + 面试录屏 + 知识库”转成可执行复盘结果：真实问答、分析报告、模拟面试。

English version: [README.en.md](README.en.md)

![应用演示](https://raw.githubusercontent.com/wind127/InterviewPilot/main/docs/assets/app-tour.gif)

## 核心特性

- 本地优先：录屏、简历、模型缓存默认保存在本地。
- 全流程闭环：资源管理 -> 分析报告 -> 模拟面试 -> 任务中心。
- 可观测任务：阶段、进度、耗时、执行器、预计剩余时间（ETA）一目了然。
- 可扩展架构：LLM / ASR Provider 可插拔替换。

## Docker 部署（推荐，优先）

先完成配置：`apps/api/.env`（DeepSeek 必填）。

下面三种部署方式是并列关系，**任选其一**：

### 方式 A：Windows PowerShell 一键部署
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/one-click-deploy.ps1
```

### 方式 B：macOS / Linux 一键部署
```bash
bash scripts/one-click-deploy.sh
```

### 方式 C：手动 Docker Compose 部署
```bash
docker compose up -d --build
```

## DeepSeek API 配置（必填）

请在 `apps/api/.env` 至少配置以下字段：

```env
RETRO_API_BASE=https://api.deepseek.com/v1
RETRO_API_KEY=<YOUR_DEEPSEEK_KEY>
RETRO_LLM_MODEL=deepseek-chat
```

完整模板见：`apps/api/.env.example`

启动后访问：
- Web：<http://localhost:5173>
- API：<http://localhost:8000>
- API Docs：<http://localhost:8000/docs>

停止服务：

```bash
docker compose down
```

## 本地开发

后端：

```powershell
cd apps/api
python -m venv .venv
.\.venv\Scripts\activate
pip install -e .[dev,local-asr]
Copy-Item .env.example .env
uvicorn retro_app.main:app --reload --port 8000
```

前端：

```powershell
cd apps/web
npm install
npm run dev
```

## 文档与社区

- 开发日志：`docs/development-log.zh-CN.md`
- 系统架构：`docs/architecture/system-architecture.md`
- 发布清单：`docs/release-checklist.md`
- v1.0 发布说明：`docs/release-notes-v1.0.0.md`
- 贡献指南：[CONTRIBUTING.md](CONTRIBUTING.md)

## License

MIT ([LICENSE](LICENSE))

InterviewPilot

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README