Vishwa

✨ Vishwa：您的智能代码伙伴

Vishwa 是一款强大的开源 AI 编程助手，旨在帮助开发者更智能、更高效地编写代码。它以命令行工具的形式与您交互，并能与 VS Code 无缝集成，带来智能变更对比和自动补全功能，让您的编码体验焕然一新！

---

💡 产品亮点一览

• 🚀 AI 驱动的终端助手： Vishwa 不仅仅是个工具，它能进行思考、推理和行动，就像您的得力助手。
• 🧠 ReAct 智能代理： 借鉴神话中的智慧工匠“Vishwakarman”之名，Vishwa 运用 ReAct（推理-行动循环）模式，将复杂任务分解并迭代解决，提供高达 15 次推理迭代。
• 🔗 多 LLM 支持： 灵活接入 Claude、GPT-4、本地 Ollama，以及通过 Novita 访问 Kimi K2、GLM-4.6 等领先模型，并支持智能故障转移链。
• 🛠️ 丰富的核心工具： 内置 Bash、文件操作（读/写/编辑）、Git 操作和网络搜索，助您应对各种编码场景。
• ⚡ 超高速代码补全： 提供毫秒级（<100ms）的实时 AI 建议，上下文感知，理解您的代码结构，大幅提升输入效率。
• 🔒 隐私优先的本地运行： 支持使用 Ollama 模型完全在本地运行，确保您的代码数据绝不离开本地环境。
• ✅ 安全可控： 对文件变更进行用户批准，支持精确的字符串替换，并深度集成 Git，方便轻松回滚，代码掌控始终在您手中。

---

🎯 Vishwa 如何让您事半功倍？

✨ AI 驱动的智能代码补全

想象一下，您正在编写代码，而一个聪明的伙伴总能及时给出最相关的补全建议。这就是 Vishwa！

• 🚀 <100ms 超低延迟： 配合本地模型，提供闪电般的补全速度。智能缓存机制，命中率高达 50-70%。
• 🔍 上下文感知： 深入分析周边代码、导入语句和文件结构，提供高度相关的建议。
• 👻 幽灵文本提示： 就像幽灵文本一样自动浮现建议，轻按 Tab 键即可接受，Esc 键即可忽略。
• 🌐 语言无关： 无论是 Python、JavaScript、TypeScript、Go 还是 Rust，Vishwa 都能轻松应对。

🧠 强大的智能代理工作流

Vishwa 的代理循环深思熟虑，帮助您自动化复杂任务，让您专注于更重要的创造性工作。

1. 🗣️ 自然语言描述： 用您自己的话语描述您想完成的任务。
2. 💡 AI 分析与规划： AI 会分析您的代码库，并规划出最佳的执行路径。
3. 🔧 工具辅助修改： 专用工具会读取、分析并修改您的代码。
4. 🤝 批准与迭代： 您可以审查并批准更改，然后根据需要继续迭代，直到满意为止。

---

模型选择与配置

Vishwa 灵活支持多种领先的 AI 模型，您可以根据任务需求或隐私考量自由选择最合适的模型：

• 推荐模型： ✨ Claude Sonnet 4.5
• 快速模型： ⚡ Claude Haiku 4.5
• 高级模型： 💎 Claude Opus 4, GPT-5.1 Pro
• 推理任务： 🧠 Kimi K2 Thinking, DeepSeek V3.2
• 通用模型： 🌐 GLM-4.6, Qwen3 Next 80B

您还可以选择完全离线运行，享受极致的隐私保护！

🛠️ 快速上手 Vishwa

开启您的 Vishwa 之旅，让 AI 成为您编码的得力助手，只需以下几步：

🚀 Linux/macOS 用户

1. 克隆并安装：

   git clone https://github.com/srujan375/Vishwa.git && cd Vishwa && ./install.sh

2. 设置 API 密钥：

   export ANTHROPIC_API_KEY="your-key-here"

3. 启动 Vishwa：

   vishwa "Explain this codebase"

💻 Windows 用户 (PowerShell)

1. 克隆并安装：

   git clone https://github.com/srujan375/Vishwa.git; cd Vishwa; .\\install.ps1

2. 设置 API 密钥：

   $env:ANTHROPIC_API_KEY="your-key-here"

3. 启动 Vishwa：

   vishwa "Explain this codebase"

🧑‍💻 开发者安装 (从源码)

1. 克隆仓库：

   git clone https://github.com/srujan375/Vishwa.git && cd Vishwa

2. 创建虚拟环境：

   python -m venv .venv && source .venv/bin/activate

3. 以可编辑模式安装：

   pip install -e .

🌍 想使用本地模型？

安装 Ollama 后，运行以下命令即可：

ollama pull gemma3:4b