WingNews logo WingNews
top | item 43345575

Show HN: Nuanced – Help AI understand code structure, not just text

34 points| aymandfire | 11 months ago |nuanced.dev

Hi HN! We built Nuanced (https://github.com/nuanced-dev/nuanced), an open-source Python library that makes AI coding tools smarter about code structure.

The problem: current AI coding assistants see code as just text. They don't understand which functions call which, or how code components depend on each other. This is why they often suggest changes that break dependencies they should have known about.

Nuanced solves this by generating call graphs that map these relationships. When you ask "What would break if I change this function?", instead of guessing, the AI can see the actual dependencies.

How it works:

1. Run `nuanced init .` to analyze a Python module in your codebase

2. Use `nuanced enrich app/file.py function_name` to get relationship data

3. Include this data in your AI prompts or integrate it into tools

We're already working with teams building AI coding assistants and security review tools to integrate this capability. Our initial release supports Python with plans for JavaScript/TypeScript next.

I'd love your feedback, especially if you're building dev tools that could benefit from better code structure understanding!

13 comments

order

ianbutler|11 months ago

Hey this is sweet, we have our own internal version of this including graph search based on the call-graph which we use to great effect in our agent.

Glad to see people making something like this more generally available.

aymandfire|11 months ago

Thanks! If you ever wanna trade notes or if we can be of any help, feel free to reach out at ayman@nuanced.dev!

apetuskey|11 months ago

This looks interesting! I want to try it out for a project we are working on, but we would need some of the features like callers, doctoring, and typing

What is the timeline on the coming soon features?

aymandfire|11 months ago

Hey, happy to chat about timeline estimates if you wanna shoot me an email at ayman@nuanced.dev

deeplyoptional|11 months ago

This is awesome. Looking forward to TS support. Soon I hope?

gaploid|11 months ago

Hmm, probably its better to use yaml or something more token optimized. That output graph for large projects could eat a lot of tokens, I guess.

topazas|11 months ago

Title misleading - not CODE, just python.

aymandfire|11 months ago

Hi there! Like I said in the post, we're actively developing support for JS/TS next, and are building toward a language-extensible project. We started with an open-source Python tool. :)