Metadata-Version: 2.4
Name: findyou
Version: 0.1.0
Summary: Autonomous Recruiting Agent - 持续发现、理解、匹配、触达人才
Author: findyou team
License: MIT
Keywords: recruiting,agent,hr,automation,llm
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: SQLAlchemy>=2.0.0
Requires-Dist: openai>=1.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: lxml>=4.9.0
Requires-Dist: APScheduler>=3.10.0
Requires-Dist: loguru>=0.7.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"

# findyou — Autonomous Recruiting Agent

> 一个永不停机的 AI 招聘顾问，持续在互联网里找人、认识人、记住人、联系他们。

## 安装

```bash
pip install -e .
```

## 配置

复制示例配置并填写：

```bash
cp findyou.example.yaml findyou.yaml
```

编辑 `findyou.yaml`，填写 LLM API Key、邮箱账号等。也可用环境变量：

```bash
export FINDYOU_LLM_API_KEY=your_key
```

## 使用

```bash
# 启动 Agent（永久运行）
findyou start

# 查看状态
findyou status

# 紧急停止
findyou emergency-stop

# 恢复
findyou resume

# 岗位管理
findyou position add --id pos1 --title "LLM Researcher" --company "ACME"
findyou position list
findyou position pause pos1
findyou position resume pos1
findyou position close pos1

# 候选人管理
findyou candidate list
findyou candidate show <id>
findyou candidate pause <id>
findyou candidate stop <id>

# 触达管理
findyou outreach list
findyou outreach pause <id>

# 人工审核
findyou review list
findyou review approve <id>
findyou review reject <id>
```

## 测试

```bash
pip install -e ".[dev]"
pytest
```

## 文档

- [design.md](docs/design.md) — 技术设计文档
- [spec.md](docs/spec.md) — 功能规格文档
- [tasks.md](docs/tasks.md) — 实现任务分解
- [review.md](docs/review.md) — 文档评审报告

## 架构

```
CLI (typer) → Agent Runtime → 业务模块 → SQLite
                                ↓
              Discovery / Intelligence / Memory
              Outreach / Conversation / FAQ
```

核心原则：LLM 负责理解，程序负责执行边界。
