Skip to content

README.md

Latest commit

 

History

History
77 lines (58 loc) · 3.14 KB

README.md

File metadata and controls

77 lines (58 loc) · 3.14 KB

GemX Analyzer

Version Kubex Go Dist CI Go Version React NextJS PRs Welcome License

🇧🇷 Read in Portuguese

A continuous improvement platform for code and product — with a closed loop. From .lkt.txt to applying diffs and PRs hands-free: grompt ↔ lookatni ↔ analyzer ↔ GoBE/gdbase/logz.

“Your quality SRE that opens safe PRs, measures impact (DORA/CHI/HIR), and self-adjusts based on policies — with no vendor lock-in.”

✨ Why it exists

AI tools help in the editor, but they stop before the PR, lacking governance. GemX Analyzer closes the loop:

  1. Grompt generates the .lkt.txt (improvement spec)
  2. Analyzer plans (EXEC/CHI/DORA/Community)
  3. Lookatni validates/applies with a deterministic diff
  4. GoBE schedules/coordinates the operation
  5. gdbase/logz handle versioning and auditing
  6. Feedback returns to grompt ⇒ new iteration

🧩 Modules (quick overview)

  • analyzer (this repo): advanced reasoning, policies, cadence, cycle orchestration
  • grompt: AI hub/entrypoint (simple chat + .lkt.txt boot)
  • lookatni: deterministic parser/applier (CLI + Go/TS lib + VSCode ext)
  • GoBE: jobs/schedulers/locks (infra)
  • gdbase: artifact/diff storage
  • logz: telemetry + auditing
  • kortex: event trail (pub/sub) (optional in v0)

🛠️ Features (v0.1.0)

  • BYOK multi-provider: OpenAI · Gemini · Anthropic · Groq
  • Robust SSE (reconnection/backoff)
  • Policies: gates (minimum score, issue limit), cadence (cooldown), canary
  • Diff preview + automatic PR (or .patch to apply manually)
  • /metrics Prometheus + /healthz
  • dev/prod config: CORS, TLS, rate-limit, circuit-breaker, retry/backoff

⚡ Quickstart (90s)

# 1) Clone
git clone https://github.com/kubex-ecosystem/kubex-gemx-analyzer.git
cd kubex-gemx-analyzer

# 2) Copy example configs
cp config/examples/meta.dev.yml config/meta.yml
cp config/examples/providers.example.yml config/providers.yml
cp .env.example .env

# 3) Export your keys (or edit .env)
export OPENAI_API_KEY=sk-...
export GEMINI_API_KEY=...
export ANTHROPIC_API_KEY=...
export GROQ_API_KEY=...

# 4) Build & run
go build -o dist/gw ./cmd/gw
GEMX_ENV=development GEMX_META_CFG=config/meta.yml PROVIDERS_CFG=config/providers.yml ./dist/gw

# 5) Smoke test
curl -I http://localhost:8080/healthz
curl -s http://localhost:8080/v1/providers | jq
curl -s http://localhost:8080/metrics | head