runprompt

在终端里直接跑 LLM 提示词,告别复制粘贴

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 18 🐛 待处理 8 👀 关注 9
GitHub ↗
GitHub 星标 ★ 445
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

runprompt 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队chr15m
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai-agents,ai-development,anthropic,bash,bash-script,cli,command-line,dotprompt,gemini,gemini-ai,llm,ollama,openai,openrouter,prompt-engineering,python,shell,shell-script
GitHub 星标★ 445
上线时间2025-11-27 00:00:00
代码更新2026-09-07
仓库体积436 KB
本站数据更新2026-11-09
维护状态维护中
收录时间2026-08-09
浏览次数5

项目介绍

runprompt 是一个命令行工具,让你直接在 shell 中运行和管理 LLM 提示词。它解决了开发者频繁切换终端与聊天界面、难以复用和版本化提示词的问题。核心能力包括:通过简单的 CLI 命令调用 OpenAI、Anthropic、Gemini、Ollama 等主流模型;支持 Dotprompt 格式,将提示词作为文件管理,便于版本控制和团队协作;提供交互式提示词编辑、模板变量、多模型对比等功能。它把提示词变成可执行、可组合的命令,让 AI 能力无缝融入日常开发工作流,适合自动化脚本、快速实验和构建 AI 辅助工具。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 445

使用教程

难度:入门 约 15 分钟 部署方式:本地安装 4 步

环境要求

  • Python 3.10+
  • uv(推荐)

安装与启动步骤

  1. 1先跑仓库自带示例

    不用装,uvx 直接跑一次看效果。

    uvx --from git+https://github.com/chr15m/runprompt runprompt hello.prompt
  2. 2把提示词写成文件

    一个 .prompt 文件就是一个可复用命令,参数从管道进。

    cat article.txt | ./runprompt summarize.prompt
  3. 3用命令行传参数

    不想写字文件时可以直接给一段提示词。

    ./runprompt -p "Say hello to {{name}}" --model openai/gpt-4o '{"name": "World"}'
  4. 4串成管道

    上一步的输出直接喂给下一步,这是它最实用的地方。

    echo "John is 30" | ./runprompt extract.prompt | ./runprompt generate-bio.prompt

如何确认成功

把两个 prompt 文件用管道串起来,能一步拿到结构化结果,中间不落临时文件

注意事项

  • 它是单文件 Python 脚本,轻到可以塞进任何脚本里。
  • 提示词文件里用双花括号占位,变量从标准输入或参数来。
  • 模型名要写全(提供方/模型),写错会报找不到。
  • 管道串联时注意每步输出必须是下一步能解析的格式。
  • 对话模式用 --chat,适合需要多轮上下文的场景。

核心亮点

  • 支持 OpenAI、Anthropic、Gemini、Ollama 等主流模型,一个工具通吃
  • 提示词以文件管理,天然支持 Git 版本控制,方便团队协作
  • CLI 设计简洁,可轻松嵌入 shell 脚本和自动化流程

不足之处

  • 早期项目,文档和社区生态尚待完善
  • 功能相对单一,复杂 agent 编排能力有限

适用场景

  • 在终端快速测试不同模型的提示词效果
  • 将提示词纳入 Git 仓库,实现团队共享和版本迭代
  • 在自动化脚本中调用 LLM,如日志分析、代码生成

替代项目

dotprompt、llm、promptfoo

上一篇:ai

下一篇:KimiCodeBar-Windows

同类项目推荐

LangChain-ChatGLM-Webui 开源

上传本地文档,即刻用ChatGLM搭建私有知识库问答

基于LangChain和ChatGLM-6B等系列LLM的针对本地知识库的自动问答

★ 3305 2026-08-09
activeagent 开源

在 Rails 里直接写 AI Agent,复用现有 MVC 与后台任务

ActiveAgent Rails framework for Agent Apps

★ 986 2026-10-13
MindAct 开源

让 HuggingFace 模型直接在 MindSpore 上跑起来

MindSpore + Huggingface: Run any Transformers/Diffusers model on MindSpore with sea···

★ 920 2026-09-16
PromptHub 开源

一站式管理提示词、技能和智能体,告别碎片化,提升 AI 开发效率。

一款包含了 Prompt管理,Skill管理,Agent管理的一站式AI工具箱,助你高效管理提示词,一键···

★ 1796 2026-08-09
langchain-chatbot 开源

用 LangChain 和 Streamlit 快速搭出能聊天的 RAG 机器人

Examples of chatbot implementations with Langchain and Streamlit

★ 278 2026-08-09
streamlit-webrtc 开源

几行 Python 让 Streamlit 应用实时处理摄像头音视频

Real-time video and audio processing on Streamlit

★ 1713 2026-09-17
cl-gserver 开源

用 Actor 模型写 Lisp 并发,状态不打架

Sento - Actor framework featuring actors and agents for easy access to state and asy···

★ 261 2026-10-13
Hyper-Extract 开源

一条命令,把文本变成超图知识库

Hypergraph is more powerful. Transform unstructured text into structured knowledge w···

★ 4217 2026-08-09
opencode-orchestrator 开源

在 OpenCode 里编排多个 AI Agent,自动接力写代码

Opencode Plugin for AI-Agent Orchestration

★ 283 2026-10-01