core/go-ai

No description

Find a file

Snider 2210e0e298 docs: add README with quick start and docs links Co-Authored-By: Virgil <virgil@lethean.io>		2026-02-20 15:11:19 +00:00
ai	test: Phase 5 — testing gaps (process/RAG/ML mocks, metrics bench)	2026-02-20 06:48:31 +00:00
docs	docs: graduate TODO/FINDINGS into production documentation	2026-02-20 14:54:05 +00:00
mcp	fix(mcp): eliminate data race in TCP transport diagnostic output	2026-02-20 12:30:16 +00:00
.gitignore	chore: update module paths and add gitignore	2026-02-17 19:19:38 +00:00
CLAUDE.md	docs: graduate TODO/FINDINGS into production documentation	2026-02-20 14:54:05 +00:00
go.mod	fix(go.mod): correct replace path for core/go	2026-02-20 14:20:33 +00:00
go.sum	fix: post-split cleanup — remove test script, fix tests, update docs	2026-02-20 01:18:27 +00:00
README.md	docs: add README with quick start and docs links	2026-02-20 15:11:19 +00:00
TEST-RESULTS.md	test: validate MLX inference and scoring pipeline on M3 Ultra	2026-02-16 17:24:36 +00:00

README.md

go-ai

MCP (Model Context Protocol) hub for the Lethean AI stack. Exposes 49 tools across file operations, directory management, language detection, RAG vector search, ML inference and scoring, process management, WebSocket streaming, browser automation via Chrome DevTools Protocol, JSONL metrics, and an IDE bridge to the Laravel core-agentic backend. The package is a pure library — the Core CLI (core mcp serve) imports it and handles transport selection (stdio, TCP, or Unix socket).

Module: forge.lthn.ai/core/go-ai Licence: EUPL-1.2 Language: Go 1.25

Quick Start

import "forge.lthn.ai/core/go-ai/mcp"

svc, err := mcp.New(
    mcp.WithWorkspaceRoot("/path/to/project"),
    mcp.WithProcessService(ps),
)
// Run as stdio server (default for AI client subprocess integration)
err = svc.Run(ctx)
// Or TCP: MCP_ADDR=127.0.0.1:9100 triggers ServeTCP automatically

Documentation

Architecture — MCP server, subsystem plugin model, tool inventory, IDE bridge, transports
Development Guide — building, testing, adding tools
Project History — completed phases and known limitations

Build & Test

go test ./...
go test -race ./...
go build ./...

Licence

European Union Public Licence 1.2 — see LICENCE for details.