natural-code

natural-code bridges the gap between human thought and executable software. our mission is to make programming accessible to everyone, regardless of their technical background or experience with traditional programming languages.

we've built a language-agnostic framework that transforms your ideas into working code. simply describe what you want to build using natural language—your preferred way of thinking and expressing logic—and we handle the translation to executable code in any target programming language.

with recent breakthroughs in large language models, code generation has reached unprecedented levels of sophistication. natural code harnesses these capabilities to democratize software development. whether you're a seasoned developer looking to prototype faster or someone with no programming experience wanting to bring ideas to life, our tool adapts to your level and helps you create functional software.

Inspiration

We believe that the future of programming does not involve the writing of code, but is more focused on the development of logic. Pseudocode is how we abstract programs and simplify logic, and natural-code converts pseudo into working program files that are straightforward, easy to understand, concise, and efficient.

How we built it

The project has 3 main components. The CLI interface validates .n files and orchestrates code generation through the Claude Code using GROQ's openai/gpt-oss-120b model. A diff tracking system monitors file changes with MD5 hashing and respects .gitignore patterns, providing context for incremental updates. State is maintained in .state.json to track modifications between runs, enabling the AI to understand what changed and update only the changed parts so as to not use excessive resources or tokens. This also helps us better maintain context of the current state as opposed to generating new code every time.

Challenges we ran into

Balancing AI context was challenging too, little caused inconsistent updates, too much overwhelmed the model. We solved this with targeted diff tracking. Managing background processes with simultaneous output streaming and logging required careful subprocess handling. Implementing comprehensive .gitignore pattern matching proved more complex than expected, requiring support for globs, directory patterns, and edge cases.

Accomplishments that we're proud of

We built a tool that integrates seamlessly into existing workflows without special tooling. The intelligent diff system helps the AI make better decisions, while the .n extension pattern makes the system truly language-agnostic. Despite coordinating AI APIs, file I/O, and subprocess management, we maintained clean, readable code with production-ready logging.

What we learned

Context quality directly determines AI output quality—our diff tracking was crucial for this. We learned how LLMs excel at pattern recognition but require careful context management. Small UX details like showing PIDs and log paths significantly improve CLI usability. State management across file operations taught us to handle edge cases carefully.