Shell-AI终极简单指南：让AI成为你的命令行智能助手

【免费下载链接】shell-ai LangChain powered shell command generate and run CLI 项目地址: https://gitcode.com/gh_mirrors/sh/shell-ai

Shell-AI（shai）是一款革命性的命令行工具，它将自然语言理解能力与命令行操作完美结合。只需用日常语言描述你想完成的任务，shai就能立即生成精准的单行命令建议，让你告别复杂命令记忆的烦恼。这款工具基于LangChain框架构建，结合了InquirerPy的交互式界面，为命令行操作带来前所未有的智能体验。

🌟 为什么选择Shell-AI？

在传统命令行操作中，我们常常需要记忆大量复杂命令和参数，甚至频繁查阅文档。Shell-AI彻底改变了这种状况：

• 自然语言交互：用中文或英文直接描述需求，无需学习专业命令语法
• 多平台支持：完美运行于Linux、macOS和Windows系统
• 智能命令生成：一次提供3个命令建议，帮你找到最优解
• 灵活配置选项：支持OpenAI、Ollama、Azure和Groq等多种AI服务提供商

🚀 快速安装步骤

安装Shell-AI只需一行命令，通过PyPI即可轻松完成：

pip install shell-ai

⚠️ 注意：Linux系统需要Python 3.10或更高版本

安装完成后，只需在终端输入shai命令即可启动工具。

💡 简单使用教程

使用Shell-AI就像和助手对话一样简单。例如，如果你想进行Terraform的dry run，只需输入：

shai run terraform dry run thingy

Shell-AI会立即返回3个相关命令建议：

• terraform plan
• terraform plan -input=false
• terraform plan

你可以直接选择其中一个执行，无需手动输入复杂命令。

⚙️ 配置指南

Shell-AI提供灵活的配置方式，可通过环境变量或配置文件进行设置。配置文件位于：

• Linux/MacOS: ~/.config/shell-ai/config.json
• Windows: %APPDATA%\shell-ai\config.json

核心配置选项

环境变量	描述	默认值
OPENAI_API_KEY	OpenAI API密钥（留空则使用ollama）	无
SHAI_API_PROVIDER	AI服务提供商（openai/ollama/azure/groq）	"groq"
SHAI_SUGGESTION_COUNT	生成的命令建议数量	3
SHAI_TEMPERATURE	控制输出随机性（0.05-1.0）	0.05

Ollama配置示例

如果你使用本地Ollama服务，配置文件示例如下：

{
  "OPENAI_API_KEY": "",
  "SHAI_SUGGESTION_COUNT": "3",
  "SHAI_API_PROVIDER": "ollama",
  "OLLAMA_MODEL": "phi3.5",
  "OLLAMA_API_BASE": "http://localhost:11434/v1/",
  "SHAI_TEMPERATURE": "0.05"
}

Groq配置示例

使用Groq服务的配置方法：

1. 获取Groq API密钥
2. 设置环境变量：

export SHAI_API_PROVIDER=groq
export GROQ_API_KEY=your_api_key_here
export GROQ_MODEL=llama-3.3-70b-versatile

🛠️ 技术架构

Shell-AI的核心功能由以下关键组件实现：

• LangChain集成：shell_ai/main.py中实现了与LangChain的集成，负责AI模型交互
• 并行建议生成：shell_ai/parallel_suggestions.py提供多线程命令建议生成
• 配置管理：shell_ai/config.py处理各种配置选项

主要依赖包包括：

• langchain~=0.3.0：AI模型交互框架
• InquirerPy~=0.3.0：交互式命令行界面
• groq~=0.13.0：Groq API客户端
• langchain-groq~=0.2.0：LangChain与Groq集成

🤝 贡献指南

Shell-AI是一个开源项目，欢迎所有开发者贡献代码和想法。如果你有改进建议或新功能创意，请阅读CONTRIBUTING.md了解贡献流程。

📄 许可证

Shell-AI采用MIT许可证，详情请参见LICENSE文件。

无论你是命令行新手还是资深开发者，Shell-AI都能帮你更高效地使用命令行。立即安装体验，让AI成为你的命令行智能助手！

【免费下载链接】shell-ai LangChain powered shell command generate and run CLI 项目地址: https://gitcode.com/gh_mirrors/sh/shell-ai