top | item 45880716

Show HN: Davia – Open source visual, editable wiki from your codebase

47 points| ruben-davia | 3 months ago |github.com

Hi HN,

We’re Ruben, Afnan, and Theo, and we’re building Davia to solve a common problem: documenting and explaining large codebases is complex. It takes too long to generate even a first draft of a wiki, visuals are essential to understand the structure, internal docs should be editable in the IDE, and most solutions aren’t open.

Davia is an open source tool. You enter the path of your repo, and it generates a visual wiki you can explore and edit. Diagrams are created automatically, and you can update everything either in your IDE or in a Notion-like editor.

The project is still early, and we’d love to hear feedback, ideas, or experiences from anyone interested in documenting and sharing code internally.

GitHub: https://github.com/davialabs/davia

19 comments

order

Kyrio|3 months ago

This looks like it could be a sensible way to use LLMs in programming, although I'm not convinced AI-generated documentation can give meaningful explanations rather than paraphrase. However, since the generated wiki is editable, it seems it can be used to give a kick start to internal documentation and let the actual devs step in when it's required. I'm skittish about genAI in the workplace (or anywhere really) but this could be valuable.

However, and this might have been naïve of me, but I expected some sort of local model. And I see that you have to bring in your own vendor API keys, which implies that you let AI companies mine your codebase. Isn't that a no-go for most companies? So far I've only worked in places that banned ChatGPT over IP concerns like these. Is it already common for businesses to feed their codebases to third party LLMs?

ruben-davia|3 months ago

Exactly. The wiki is editable so AI gives a first draft, and developers refine it. Some companies are fine with vendor APIs, but we’ll add local model support for full privacy.

itsn0tm3|3 months ago

But what if you edited a section about code piece A and then you change that code? Does it have permission to overwrite? Seems like a fairly hard problem to solve.

esperent|3 months ago

Looks interesting but it needs some demos using real world complex projects.

Point it at famous open source projects like React, or three.js, and use those as examples on the homepage.

ruben-davia|3 months ago

Thanks! On our homepage (https://davia.ai/showcase) we already showcase examples like AI SDK, E2B, GPT OSS, and Transformers. We’ll also add more examples directly on our GitHub soon.

potamic|3 months ago

What's the token usage and time taken to run this for a given repository?

ruben-davia|3 months ago

Roughly 300K to 1M tokens in total. It’s big, but should only happen once per repo. And around 2 minutes to run.