# knowledgeops-agent — Ops-Ready RAG Agent Stack

> knowledgeops-agent is an ops-oriented agent app: Docker Compose deploys API + console with MySQL/Redis/RabbitMQ and an optional observability stack.

## Install

Copy the content below into your project:

## Quick Use

```bash
git clone https://github.com/however-yir/knowledgeops-agent.git
cd knowledgeops-agent

chmod +x scripts/install_mac.sh
./scripts/install_mac.sh

# or: docker compose up --build -d
```

## Intro

knowledgeops-agent is an ops-oriented agent app: Docker Compose deploys API + console with MySQL/Redis/RabbitMQ and an optional observability stack.

- **Best for:** Teams who want an agent app that starts with ops baseline (compose, migrations, logs/metrics/traces)
- **Works with:** Docker & Docker Compose; Java (Spring Boot) + Vue console; OpenAI-compatible API key (per README)
- **Setup time:** 20–45 minutes

## Practical Notes

- GitHub: 204 stars · 11 forks; pushed 2026-05-12 (verified via GitHub API).
- README provides one-click installers and a straight `docker compose up --build -d` path plus web console at `http://localhost:8088`.
- README lists an optional observability compose file with Prometheus / Loki / Tempo / Alertmanager.

## Main

If you adopt this stack, keep the “ops first” intention:

1. Start with Compose to understand the baseline services (app + MySQL/Redis/RabbitMQ) before customizing anything.
2. If you’re running it for real users, rotate any demo keys and wire proper secrets management.
3. Decide early whether you need the observability bundle; if yes, enable it from day one so you don’t retrofit tracing later.
4. Treat migrations (Flyway) and regression scripts as release gates; don’t ship changes without them.

This repo is valuable because it treats agent apps like production services rather than notebooks.

### FAQ

**Q: Is there a one-click install?**
A: Yes. README includes `scripts/install_mac.sh` and Windows scripts that guide `.env` creation and bring up Compose.

**Q: What services are included by default?**
A: README lists app + MySQL + Redis + RabbitMQ + web console; plus a separate observability compose file.

**Q: Where do I access it after startup?**
A: README lists web console at `http://localhost:8088` and API at `http://localhost:8080`.

## Source & Thanks

> Source: https://github.com/however-yir/knowledgeops-agent
> License: MIT
> GitHub stars: 204 · forks: 11

---

<!-- ZH -->

## 快速使用

```bash
git clone https://github.com/however-yir/knowledgeops-agent.git
cd knowledgeops-agent

chmod +x scripts/install_mac.sh
./scripts/install_mac.sh

# 或：docker compose up --build -d
```

## 简介

knowledgeops-agent 是带“运维基线”的 agent 全栈：Docker Compose 一键拉起 API + 控制台，并配套 MySQL/Redis/RabbitMQ；还提供独立的可观测性栈。

- **适合谁：** 希望从一开始就把运维基线带上的团队（compose/迁移/日志/指标/追踪）
- **可搭配：** Docker & Docker Compose；Java（Spring Boot）+ Vue 控制台；需要 OpenAI 兼容的 API key（见 README）
- **准备时间：** 20–45 分钟

## 实战建议

- GitHub：204 stars · 11 forks；最近更新 2026-05-12（GitHub API 验证）。
- README 提供安装脚本与 `docker compose up --build -d` 的直接启动方式，控制台在 `http://localhost:8088`。
- README 给出独立可观测性 compose：Prometheus / Loki / Tempo / Alertmanager。

## 主要内容

把它落地成“真能跑的服务”，建议遵循它的 ops-first 思路：

1. 先用 Compose 跑通基线服务（应用 + MySQL/Redis/RabbitMQ），再做定制。
2. 面向真实用户时务必轮换 demo key，并接入正规的密钥管理。
3. 早决定是否启用可观测性栈；如果需要，尽早打开，避免后期补 trace。
4. 把迁移（Flyway）与回归脚本当作发布闸门，不通过就不发版。

这个仓库的价值在于：它把 agent app 当作生产服务来设计，而不是 notebook 示例。

### FAQ

**有一键安装吗？**
答：有。README 提供 `scripts/install_mac.sh` 以及 Windows 脚本，会引导生成 `.env` 并启动 Compose。

**默认包含哪些服务？**
答：README 列出应用 + MySQL + Redis + RabbitMQ + Web 控制台；可观测性栈在独立 compose 文件里。

**启动后从哪访问？**
答：README 写明控制台 `http://localhost:8088`，后端 API `http://localhost:8080`。

## 来源与感谢

> Source: https://github.com/however-yir/knowledgeops-agent
> License: MIT
> GitHub stars: 204 · forks: 11


---
Source: https://tokrepo.com/en/workflows/knowledgeops-agent-ops-ready-rag-agent-stack
Author: AI Open Source