ARCANGEL0/NekoCLI
GitHub: ARCANGEL0/NekoCLI
NekoCLI 是一款终端多模式 AI 助手，将代码生成、图像/视频创作、网络搜索和渗透测试代理整合到单一命令行工具中，无需 OpenAI API 费用。
Stars: 18 | Forks: 3
**你的终端 AI 助手，能够查看、编辑或生成图像；创建短视频；生成并保存代码/脚本；运行命令以及回答或协助处理任何主题。** [](https://github.com/ARCANGEL0/NekoCLI) [](https://github.com/ARCANGEL0/NekoCLI) [](https://github.com/ARCANGEL0/NekoCLI/fork) [](https://github.com/ARCANGEL0/NekoCLI) [](#)     
⬡ 关于 NEKO
NEKO 是一款轻量、快速且实用的终端 AI 助手，可随时供你访问。
它支持多种 flag 和模式，并在你的终端窗口中提供整洁格式化且色彩丰富的输出，例如持久化的聊天记录、代码模式、shell 模式、视频生成、图像编辑与创建、网络搜索、视觉模式以及一个可选的 pentest agent (beta)。
## ᗢ 功能
- **快速与轻量** – 依赖极少，单个二进制文件即可实现瞬间启动。
- **多种模式** – 结合 GPT5 的 AI 聊天 + 网络搜索与实时内容，shell 命令与执行，代码生成，图像与视频生成，图像分析与编辑，以及具备交互式和自主执行能力的 pentest 模式。
- **格式化输出** – 方便在终端中可视化数据，输出结果在多彩的 colorama 框中显示。
- **持久化历史记录** – 配合持久化 flag 使用时，会保留聊天的上下文。聊天记录保存在 `~/neko/chat.json`，pentest 记录保存在 `~/neko/pentest.json`
- **免费 endpoint** – 所有 AI 逻辑均通过我自己的 API endpoint 运行，或者也可以使用 ollama 进行离线模式，通过编辑 OLLAMA_BASE_URL 来更改 *:11434 的 base api。
- **媒体文件处理** - Neko 不仅能可视化图像，还能根据用户的 prompt 生成视频和图像并进行编辑。
⟢ 安装 .ᐟ
### 选项 1：Pip 安装（推荐）
```
pip install nekocli
```
这会全局安装 `neko` 命令，你可以在任何地方使用它。
### 选项 2：从仓库克隆
克隆仓库并运行安装程序：
```
git clone https://github.com/ARCANGEL0/NekoCLI
cd NekoCLI
./install.sh
```
这会将 NekoCLI 安装到 `~/nekoCLI` 并将其添加到你的 PATH 中。安装完成后，你可以在终端的任何地方使用 `neko`。
⬥ 用法 .ᐟ
你可以在终端的任何地方调用 neko 并带上一个 prompt 来提问，你也可以传递 stdin 参数供 NEKO 读取。
```
$ cat serverLogs.txt | neko "Analyze these logs and return a solution for it"
```
要更新 NEKO，请运行：
```
$ neko -u
```
你还可以在 NEKO 中使用自定义 flag 来实现不同的操作模式。
用法：neko [options] {question or prompt}
| Flag | 描述 |
|---------|-------------|
| `-w` / `--web` | 结合网络搜索和实时结果进行提问 |
| `-c` / `--code` | 告诉 neko 处理代码生成，创建一个可完全运行的代码，并能够直接保存到文件中 |
| `-s` / `--shell` | 告诉 neko 根据用户请求解释、生成并运行 shell 命令。 |
| `-i` / `--interactive` | 启动交互式聊天，并使用 `~/neko/chat.json` 中持久化的历史记录 |
| `-l` / `--load` | 为非交互式请求加载/保存持久化的聊天记录 |
| `-f` / `--file` | 连同用户 prompt 一起发送图像供 neko 分析。 |
| `-g` / `--generate` | 要求 Neko 使用 prompt 生成图像 |
| `-gv` / `--generate-video` | 要求 Neko 使用 prompt 生成一个 8 秒的短视频 |
| `-e` / `--edit` | 要求 Neko 根据你的请求编辑图像 |
| `-a` / `--auto` | (实验性功能 [!]) 自主多步骤进攻性安全模式，传递一个初始 prompt，让 neko 自动运行命令并从输出中学习，持续针对目标生成下一步操作 |
| `-x` / `--agent` | 以网络安全 agent 模式启动 neko，处理安全、pentest 问题，并就命令输出提供建议 |
| `-r` / `--reset` | 清除保存在 ~/neko 的聊天记录 |
| `-h` / `--help` | 显示帮助菜单 |
| `-n` / `--neofetch` | 显示系统信息 |
| `-u` / `--update` | 更新 Neko |
| `-v` / `--version` | 显示当前版本 |
### ⑇ 示例
```
$ neko -s "list all files sorted by size" # generates a command and asks user if he wants to Run it.
$ neko -c "Python script to merge two CSV files" # generates a short text and full python code, and asks user to copy code or save as a file in local dir.
$ neko -w "Latest CVE for OpenSSL in the last 2 months" # searches web for all possible index and findings on user prompt (CVE searches)
$ neko -a "Help me in a pentest process, to enumerate this IP 10.10.x.x and get a webshell" # neko will provide suggestions and commands to be run and ask authorization to run them, after running he will self collect the logs, analyze and suggest next steps and repeat the cycle.
$ neko -f /home/user/kitty.jpg "can you tell me the color of this cat?"
$ neko -g "Please generate an image of Donald trump vs Joe Biden in a MMA Octagon ring, both fighting" # Image generation with Neko
$ neko -gv "A video of a orange cat walking slowly in a cyberpunk city" # Video generation with Neko, usually a short video of 6 to 8 seconds.
$ neko -e /home/user/selfie.jpg "Please change the background and remove the people on it" # Neko will modify the image with AI and obey the request to remove people on background
$ neko -i "Tell me about Rutherford atom model" # after output, you will have option to ask a new question i.e: ''What about Schrodinger model?'' and continue conversation in context.
$ neko -wsl "find me a command to curl this endpoint with auth header" # combined short flags are supported (-w -s -l)
$ neko -x "i need help to enumerate 192.168.0.10 for open ports" # neko will return a small and a list of commands to be run by user, and ask them to retrieve the logs by calling command again, as in example below
$ cat nmapOutput.txt | neko -x "i have run nmap and found these info, what do you suggest now?" # Continues conversation saved on chat.json, analyzes nmap output and proceeds to suggest next steps
$ neko -r # resets all chat history.
$ neko --version # Outputs v7.2 🐈
```
🗈 项目说明
```
| Not much to say, I just needed an interactive AI to speed up my workflow in terminals, and assist at pentesting or
coding and hitting Alt + Tab consistently to navigate through documentations, chatGPT for assistance,
among other things can be quite annoying.
And most repo's that offer similar solutions always require an OpenAI key, which I, as an Engineer Grad. student,
cannot afford because by tides of destiny, I was born poor.
So I decided to make my own CLI assistant using my own server for Free GPT 5-1 with
reasoning and vision capabilities without costs, making me able to
do all i need inside a single tty shell. 🐈
```
Hack the world. Byte by Byte. ⛛
𝝺𝗿𝗰𝗮𝗻𝗴𝗲𝗹𝗼 @ 2025 **[[ꋧ]](#-关于-NEKO))**