frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Show HN: Brodocs deep onprem knowledge harvester

2•BroTechLead•3w ago
Hi HN,

Sharing onprem version of markdown knowledge harvester and publisher https://brodocs.io. It should make easy setting up internal tech docs portals from multiple git repos like micro/nano services, terraform modules, ansible roles, arch docs.

To start just: docker run -it --rm --name brodocs -p20000:20000 ghcr.io/brodocsdev/brodocs:0.14.0

then init some site from git repository: curl -X POST 'http://localhost:20000/api/sites/init' -F "repo=https://github.com/brodocsdev/docs.git"

then go to: http://localhost:20000/10b0eb6e1dc27c0babd/docs/README.html

Features already built:

- add more repos to init with -F "repo=url" -F "repo=url2" ...

- if key is needed: -F "key=...", it is stored encrypted in container

- it will check for changes every 5 minutes, so no need to setup ci/cd pipilines, just drop it on vm or k8s

- PlantUML conversion built-in, no need to commit image (mermaid still missing since it needs chrome, container size goes over 1GB),

- building cross team sites with top menu: https://brodocs.io/d248c24a335845277b6/docs/Multisites%20wit...

Any suggestions what operations expose on MCP, how to construct llm.txt, are welcome.