KJ

karmaloopai/jiva

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

35 stars 8 forks 质量 77 趋势 26MIT

Jiva 是一款基于 CLI 的开源自主 AI 代理,是 Claude 的开放替代方案。它用 TypeScript 编写,原生支持 Sarvam-105B 和 gpt-oss-120b,能够自主规划和执行......

概览

Jiva 是终端和云端的自主 AI 代理。它支持任何兼容 OpenAI 的模型提供商,支持两种执行模式——用于复杂任务的通用双代理系统(Manager + Worker),以及带有 LSP 集成的代码优化单循环引擎,用于软件工程。 设置向导会打开,提供者选择菜单。选择你的提供商,Jiva 会自动填充端点、型号名称和工具格式——您只需提供 API 密钥即可。支持的提供者:、 及任何端点。 设置完成后,运行以确认你所选型号和配置在代码模式下是否最优运行。它会根据你的配置执行一组确定性编码任务;健康的配置会通过所有这些任务。有关调优和能力比较,请参见基准测试。 一个为复杂多步任务设计的双代理流水线: 工作者可以访问任何已配置的MCP服务器(文件系统、浏览器自动化、shell命令等)。

概述(AI 翻译)

Jiva 是终端和云端的自主 AI 代理。它支持任何兼容 OpenAI 的模型提供商,支持两种执行模式——用于复杂任务的通用双代理系统(Manager + Worker),以及带有 LSP 集成的代码优化单循环引擎,用于软件工程。

演示


安装

设置向导会打开一个提供者选择菜单。选择你的提供者,Jiva 会自动填充端点、型号名称和工具格式——你只需输入 API 密钥即可。支持的提供者:Krutrim、Groq、Sarvam、OpenAI 以及任何**兼容 OpenAI ** 的端点。

设置完成后,运行**jiva benchmark以确认你所选模型和配置在代码模式下是否最优运行。它会对你的配置运行基线(任务存储)套件**——一组确定性的编码任务;健康的配置能通过所有这些任务。有关调优和能力比较,请参见基准测试。

开发安装


快速启动

REPL指令

指挥 描述
/help 显示可用命令
/tools 列表活动工具
/servers 显示MCP服务器状态
/save 保存当前对话

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Jiva

Jiva is an autonomous AI agent for the terminal and cloud. It works with any OpenAI-compatible model provider and supports two execution modes — a general-purpose two-agent system (Manager + Worker) for complex tasks, and a code-optimized single-loop engine with LSP integration for software engineering.

Demo


Installation

npm install -g jiva-core
jiva setup

# Verify your model + config can do code mode well:
jiva benchmark

The setup wizard opens with a provider selection menu. Choose your provider and Jiva auto-fills the endpoint, model name, and tool format — you only supply your API key. Supported providers: Krutrim, Groq, Sarvam, OpenAI, and any OpenAI-compatible endpoint.

After setup, run jiva benchmark to confirm your chosen model and configuration work optimally in code mode. It runs the baseline (taskstore) suite — a deterministic set of coding tasks — against your config; a healthy setup passes all of them. See Benchmarking for tuning and capability comparison.

Development install

git clone https://github.com/KarmaloopAI/Jiva.git
cd Jiva
npm install && npm run build && npm link
jiva setup

Quick Start

# General-purpose interactive session
jiva chat

# Code mode — optimized for software engineering tasks
jiva chat --code

# Code mode with plan-then-approve flow
jiva chat --code --plan

# Single prompt
jiva run "What changed in the last 5 commits?"

# Single prompt in code mode
jiva run "Add error handling to the database module" --code

REPL commands

Command Description
/help Show available commands
/tools List active tools
/servers Show MCP server status
/save Save current conversation
/load Resume a saved conversation
/list Browse all saved conversations
/reset Clear conversation history
/ Load a skill (e.g. /graphify)
/exit Exit Jiva

Execution Modes

General mode (default)

A two-agent pipeline designed for complex, multi-step tasks:

User Request
    ↓
Manager Agent    — plans, decomposes, and synthesizes
    ↓
Worker Agent     — executes subtasks with MCP tools
    ↓
Response

The Worker has access to any configured MCP server (filesystem, browser automation, shell commands, etc.). The Manager synthesizes results from all subtasks into a final coherent response. Simple conversational messages are answered directly without executing subtasks.

Code mode (--code)

A single streaming loop optimized for coding tasks:

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

# Per-invocation: pass server names via --mcp (comma-separated) jiva chat --code --mcp browser jiva chat --code --mcp browser,postgres # Persistent: set codeMode:true on any server in your config jiva config # or edit ~/.config/jiva/config.json: # "mcpServers": { "browser": { "command": "...", "codeMode": true } }