loop-agent-cli
Typer + Rich CLI for recruit-loop-agent — 在终端中完成招聘循环的全部操作,无需启动 FastAPI Web 服务。
功能特性
- 零服务依赖:不启动 uvicorn,直接在进程内调用核心引擎
- 完整功能覆盖:职位管理、候选人查看、管道操作、循环执行、调度控制、仪表盘
- 终端友好:Rich 彩色表格/面板,结构化输出
安装
# 从 PyPI 安装(正式发布后)
pip install loop-agent-cli
# 开发模式安装(从项目根目录)
cd recruit-loop-agent
pip install -e .
前置条件
- Python >= 3.11
.env文件需存在于项目根目录(配置GITHUB_TOKEN、SMTP_*等)- 项目根目录需包含
app/核心引擎包
使用示例
查看帮助
loop-agent --help
职位管理
# 列出所有职位
loop-agent position list
# 创建新职位
loop-agent position create -t "Senior Backend Engineer" -c "Tech Corp" \
-s "Python,FastAPI,PostgreSQL" -k "backend,python,remote"
# 查看职位详情
loop-agent position show <position_id>
# 关闭职位
loop-agent position close <position_id>
执行招聘循环
# 对已有职位执行一次循环
loop-agent run position <position_id>
# 创建职位并立即执行循环
loop-agent run create-and-run -t "Python Developer" -c "Startup Inc" \
-s "Python,Django" -i 30
候选人管理
# 列出候选人(默认 20 条)
loop-agent candidate list -n 10
# 查看候选人详情
loop-agent candidate show <candidate_id>
管道管理
# 列出所有管道
loop-agent pipeline list
# 按职位过滤
loop-agent pipeline list -p <position_id>
# 更新管道状态
loop-agent pipeline update-status <pipeline_id> contacted
调度管理
# 启动后台调度器(Ctrl+C 退出)
loop-agent schedule start
# 列出调度任务
loop-agent schedule list
仪表盘
# 查看仪表盘摘要
loop-agent dashboard
其他
# 显示 LangGraph 图结构
loop-agent graph
# 显示版本信息
loop-agent version
全局选项
# 覆盖数据库路径
loop-agent --db sqlite+aiosqlite:///./custom.db position list
命令树
loop-agent
├── run 执行招聘循环
│ ├── position <position_id> 对已有职位执行一次循环
│ └── create-and-run 创建职位并立即执行循环
├── position 职位管理
│ ├── list 列出所有职位
│ ├── create 创建新职位
│ ├── show <position_id> 查看职位详情
│ └── close <position_id> 关闭职位
├── candidate 候选人管理
│ ├── list 列出候选人
│ └── show <candidate_id> 查看候选人详情
├── pipeline 招聘管道管理
│ ├── list 列出管道
│ └── update-status 更新管道状态
├── schedule 调度管理
│ ├── start 启动后台调度器
│ └── list 列出调度任务
├── dashboard 查看仪表盘摘要
├── graph 显示 LangGraph 图结构
└── version 显示版本信息
开发
# 克隆项目
git clone git@github.com:Chandler-Song/recruit-loop-agent.git
cd recruit-loop-agent
# 创建虚拟环境
python -m venv venv
source venv/bin/activate
# 安装依赖
pip install -e .
# 运行测试
pytest app/tests/ -v
许可证
MIT License
Metadata
Release files for loop-agent-cli 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| loop_agent_cli-0.1.0.tar.gz | 42.1 kB | Without provenance | Details for loop_agent_cli-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| loop_agent_cli-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for loop_agent_cli-0.1.0-py3-none-any.whl |
Total release size: 105.1 kB
Release files / loop_agent_cli-0.1.0.tar.gz
| Download URL | loop_agent_cli-0.1.0.tar.gz |
|---|---|
| Size | 42.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e391ee6f23dfb3bb65a75b088935db647364edcb9448a89f7d5649c6a0111f51
|
|
BLAKE2b-256 checksum How to use checksums |
3afaa42477ea02362570394a955fb71968062aff8a7719b1c9ea47d467b728da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.13
|
Release files / loop_agent_cli-0.1.0-py3-none-any.whl
| Download URL | loop_agent_cli-0.1.0-py3-none-any.whl |
|---|---|
| Size | 63.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
98da5d959583c84df766fa9db6bd5d1f769ceba835730486bc30c7b8cbb87993
|
|
BLAKE2b-256 checksum How to use checksums |
e6c0c13d1e35a7cae6b6533ec0f3b73fecd658d5edaf80846fc149ad512e89d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.13
|
Security for loop-agent-cli 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.