# FauniSearch

FauniSearch 是一个本地优先的多模态检索系统。

当前阶段已经具备真实链路和最小 UI 闭环，但仍然以研发和验证为主。

## Features

- 以文搜索：以文本作为查询，在同一库中检索图片、文档页和视频片段相关内容
- 以图搜索：支持上传单张查询图片，也支持把库内 `image` / `document_page` 结果对象直接复用为新的 query image
- 以视频搜索：支持上传本地查询视频、指定时间范围的视频片段查询，以及把库内 `video_segment` 直接复用为新的查询视频片段
- 以文档搜索：支持上传 PDF、整份文档查询、页范围查询，以及把库内 `document_page` 结果对象直接复用为新的查询文档

## Quick Start

1. 初始化仓库环境

<!-- end list -->

```bash
bash scripts/local/bootstrap-linux.sh
```

2. 启动本地服务

<!-- end list -->

```bash
bash scripts/local/run.sh
```

## Docs

- [本地运行](https://github.com/wowfun/fauni-search/blob/b2c36d18c2f097249d60ef42343226d4059119d6/docs/run-local.md)：最小安装、启动、验证和运行期说明
- [排障](https://github.com/wowfun/fauni-search/blob/b2c36d18c2f097249d60ef42343226d4059119d6/docs/troubleshooting.md)：常见问题入口

## 项目结构

主要目录：

- `src/`：Rust 主服务
- `sidecar/`：Python sidecar 与 modeld，模型运行和媒体处理
- `ui/`：应用界面
- `tests/`：共享测试与集成验证

## Development Baseline

- 当前标准开发环境：`Linux/WSL2 + NVIDIA GPU`
- 当前主链：Rust 主服务 + modeld + Python sidecar + Qdrant + 最小 UI
- 当前模型策略：`local_sidecar` 配置目录驱动 modeld；默认加载 `ColQwen3.5-4.5B-v3`，`Qwen3-VL-Embedding-2B` 作为第二本地 backend
- 当前阶段不使用 Docker、devcontainer 或 Nix

如果你准备修改能力边界或实现语义，先读对应 `specs/` 下的事实源；如果你只是想跑起来或排障，优先从 [docs/run-local.md](https://github.com/wowfun/fauni-search/blob/b2c36d18c2f097249d60ef42343226d4059119d6/docs/run-local.md) 和 [docs/troubleshooting.md](https://github.com/wowfun/fauni-search/blob/b2c36d18c2f097249d60ef42343226d4059119d6/docs/troubleshooting.md) 开始。