FuzzyAI

环境要求

• Python 环境（README 未指定具体版本，需能使用 pip）
• pip 或任意其它 Python 包管理器
• 独立项目方式需要 Poetry（https://python-poetry.org/）
• 可选：ollama 本地模型运行时（https://ollama.com/download/）
• 可选：本地运行 llama3.1 需约 4.7 GB 磁盘空间

安装与启动步骤

1. 1安装 FuzzyAI

   在已有 Python 项目中直接用 pip 从 GitHub 安装 fuzzyai 包，这是快速上手方式一。

   pip install git+https://github.com/cyberark/FuzzyAI.git

   复制

2. 2验证安装并查看帮助

   运行 fuzz 子命令的 -h 帮助，确认命令已可用并了解可用参数。

   fuzzyai fuzz -h

   复制

3. 3克隆仓库

   方式二：作为独立项目使用，先从 GitHub 克隆仓库并进入目录。

   git clone git@github.com:cyberark/FuzzyAI.git
   cd FuzzyAI

   复制

4. 4用 Poetry 装依赖

   在仓库目录下通过 Poetry 以可编辑模式安装项目依赖。

   poetry run pip install -e .

   复制

5. 5运行 fuzzer

   在 Poetry 环境中运行 fuzzer 帮助命令，确认独立项目方式可用。

   poetry run fuzzyai fuzz -h

   复制

6. 6可选下载本地模型

   可选步骤：安装 ollama 后拉取 llama3.1 供本地测试，约 4.7 GB。

   ollama pull llama3.1
   ollama show llama3.1

   复制

如何确认成功

执行 fuzzyai fuzz -h（或 poetry run fuzzyai fuzz -h）能正常打印帮助信息即安装成功；用 ollama show llama3.1 可确认本地模型已就绪。

常见问题

注意事项

• 安装命令需要联网访问 GitHub 与 PyPI。
• 独立项目方式必须使用 Poetry 运行命令，直接执行可能找不到依赖。
• README 节选未说明 API Key、目标模型端点等配置，实际测试前请查阅仓库完整说明。
• 本工具用于对自有 LLM API 做安全评估，请勿用于未授权目标。