Pre-release
This release is a pre-release and may not be stable for production use.
WhiskerRAG
WhiskerRAG 是为 PeterCat 和 Whisker 项目开发的 RAG（Retrieval-Augmented Generation）工具包，提供完整的 RAG 相关类型定义和方法实现。
特性
- 针对通用 RAG 的领域建模类型, 包括任务（Task）、知识（Knowledge）、分段(Chunk)、租户(Tenant)、知识库空间(Space)。
- Whisker rag 插件接口描述。
- Github 仓库、S3 资源管理器。
安装
使用 pip 安装：
pip install whiskerrag
快速开始
whiskerrag 包含三个子模块，分别是 whiskerrag_utils、whiskerrag_client、whiskerrag_types。它们分别有不同的用途：
whiskerrag_utils
包含了构建 RAG 系统的常用方法：
from whiskerrag_utils import loader,embedding,retriever
whiskerrag_client
将 RAG 系统服务通过 python sdk 的形式向外暴露。
from whiskerrag_client import APIClient
api_client = APIClient(
base_url="https://api.example.com",
token="your_token_here"
)
knowledge_chunks = await api_client.retrieval.retrieve_knowledge_content(
RetrievalByKnowledgeRequest(knowledge_id="your knowledge uuid here")
)
space_chunks = await api_client.retrieval.retrieve_space_content(
RetrievalBySpaceRequest(space_id="your space id here ")
)
chunk_list = await api_client.chunk.get_chunk_list(
page=1,
size=10,
filters={"status": "active"}
)
task_list = await api_client.task.get_task_list(
page=1,
size=10
)
task_detail = await api_client.task.get_task_detail("task_id_here")
whiskerrag_types
一些辅助开发的类型提示，接口；
from whiskerrag_types.interface import DBPluginInterface, TaskEngineInterface
from whiskerrag_types.model import Knowledge, Task, Tenant, PageParams, PageResponse
开发者指南
环境初始化
- 克隆项目
git clone https://github.com/petercat-ai/whiskerrag_toolkit.git
cd whiskerrag_toolkit
- 创建并激活虚拟环境
# 查看poetry配置
poetry config --list
# 修改 poetry 配置
poetry config virtualenvs.create true
poetry config virtualenvs.in-project true
poetry env use python3.10
# 激活虚拟环境
source .venv/bin/activate
- 安装依赖
# 安装项目依赖
poetry install
# 安装 pre-commit 工具
pre-commit install
- 运行测试
# 运行所有测试
poetry run pytest
# 运行指定测试文件
poetry run pytest tests/test_loader.py
- poetry 常用命令
# 安装依赖
poetry install
# 添加新依赖
poetry add package_name
# 添加新 dev 依赖
poetry add --dev package_name
# 更新依赖
poetry update
# 查看环境信息
poetry env info
# 查看已安装的包
poetry show
开发工作流
- 创建新分支
- 开发新功能，补充单元测试，确保代码质量。注意，请确保单元测试覆盖率不低于 80%。
- 提交代码，并创建 Pull Request。
- 等待代码审查，并根据反馈进行修改。
- 合并 Pull Request。
项目结构
whiskerRAG-toolkit/
├── src/
│ ├── whiskerrag_utils/
│ └── whiskerrag_types/
│ └── whiskerrag_client/
└── pyproject.toml
贡献指南
- Fork 本仓库
- 创建特性分支 (
make branch name=feature/amazing-feature) - 提交更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 开启 Pull Request
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
联系方式
项目维护者 - @petercat-ai
1 maintainer
Metadata
1 maintainer
Release files for whiskerrag 0.1.19.dev20250709053552
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| whiskerrag-0.1.19.dev20250709053552.tar.gz | 47.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| whiskerrag-0.1.19.dev20250709053552-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 124.5 kB
Release files / whiskerrag-0.1.19.dev20250709053552.tar.gz
| Download URL | whiskerrag-0.1.19.dev20250709053552.tar.gz |
|---|---|
| Size | 47.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2db0722c38e07ec73eb457558c585935f7646ef3ebf8ad7e98bc8da50dc1cbb0
|
|
BLAKE2b-256 checksum How to use checksums |
d48a65c2e7da2fecfc2d4887fdb6b91a5a4770cb16427b00e91d7fcee85c4e2a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.12.11 Linux/6.11.0-1015-azure
|
Release files / whiskerrag-0.1.19.dev20250709053552-py3-none-any.whl
| Download URL | whiskerrag-0.1.19.dev20250709053552-py3-none-any.whl |
|---|---|
| Size | 77.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3460a461f8a569a9e20627bed51e953751810089507236e9b34ca7d6c305d8cc
|
|
BLAKE2b-256 checksum How to use checksums |
0c13181283ec171bed69fd709247b1a7e5b7552b787b0a10cae7e2ccd5b8b61c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.12.11 Linux/6.11.0-1015-azure
|
