Describe what you want in an intent file; the compiler uses Claude to write the code.
- dbbasic_compiler
- docs
- intent
- .gitignore 202 bytes
- LICENSE 1.0 KB
- MANIFEST.in 96 bytes
- README.md 4.4 KB
- pyproject.toml 1.2 KB
- requirements.txt 18 bytes
- setup.py 1.2 KB
DBBasic-Compiler
The compiler that understands English.
Traditional compilers check syntax and throw errors. DBBasic-Compiler understands what you want and generates optimal code.
For 70 years, compilers have been mechanical syntax checkers. Now there's one that thinks.
Quick Start
1. Install:
pip install dbbasic-compiler
2. Set your API key:
export ANTHROPIC_API_KEY='your-api-key'
3. Write an intent file (describe what you want):
# Calculator
Create a simple calculator program.
## Features
- Add, subtract, multiply, divide
- Handle division by zero
- Loop until user types "quit"
4. Compile and run:
dbbasic-compile calculator.intent.md
dbbasic-compile run calculator
That's it. No code written. Just intent compiled to execution.
Use it anywhere like gcc or python - it's globally installed.
What Is This?
A compiler that:
- Understands natural language (no syntax to learn)
- Asks clarifying questions (no cryptic error messages)
- Generates optimal code (not just syntax checking)
- Validates correctness (against your intent)
Traditional Compiler vs DBBasic-Compiler
Traditional Compiler (GCC, Python, etc):
$ gcc program.c
program.c:42:5: error: expected ';' before 'return'
Dumb syntax checker. You fix semicolons.
DBBasic-Compiler:
$ dbbasic-compile myapp.intent.md
[AI Compiler] Understanding problem description...
[AI Compiler] ✓ Compilation successful!
Intelligent translator. It understands intent.
Examples
Hello World
Intent file (intent/hello_world.intent.md):
# Hello World - Greeting Program
Create a simple program that greets users.
## What It Should Do
1. Ask the user for their name
2. Greet them with a friendly message
3. Ask if they want to greet someone else
4. If yes, repeat; if no, say goodbye
Compile and run:
dbbasic-compile hello_world.intent.md
dbbasic-compile run hello_world
Output:
What's your name? Alice
Hello, Alice! Nice to meet you!
Greet someone else? (yes/no): no
Goodbye! Have a great day!
More Examples
See intent/ directory for example intent files.
How It Works
Intent Description (.intent.md)
↓
AI Compiler (Claude Sonnet 4.5)
- Understands natural language
- Generates optimal implementation
- Handles edge cases
↓
Executable Code (.py)
↓
Runs!
Commands
# Compile an intent file
dbbasic-compile <name>.intent.md
# Run a compiled program
dbbasic-compile run <name>
# List all compiled programs
dbbasic-compile list
Philosophy
Code is a liability, not an asset. Intent is the asset.
Programming should be about clearly describing problems, not fighting syntax errors.
DBBasic-Compiler makes problem description the programming language.
The Paradigm Shift
Old Way:
- Think of solution
- Translate to Python syntax
- Fix syntax errors
- Fix logic errors
- Add error handling
- Test
New Way:
- Describe the problem clearly
- Compile
- Run
Why "Compiler"?
For 70 years, compilers have been:
- Syntax validators
- Mechanical translators
- Rule followers
But now we have AI that can:
- Understand intent
- Make decisions
- Learn patterns
- Ask questions
We're not misusing the term "compiler." We're using it correctly for the first time.
A compiler should compile ideas into code, not just check syntax.
Part of DBBasic
DBBasic is about simplicity:
- DBBasic framework: Simple Python web framework
- DBBasic-Compiler: Simple way to write programs
Both share:
- Minimalism over complexity
- Readability over magic
- Simplicity over features
Requirements
- Python 3.7+
- Anthropic API key (Claude Sonnet 4.5)
Get your API key: https://console.anthropic.com/
Installation
pip install dbbasic-compiler
export ANTHROPIC_API_KEY='your-api-key'
Get your API key: https://console.anthropic.com/
PyPI Package
Available on PyPI: https://pypi.org/project/dbbasic-compiler/
Contributing
This is experimental. We're exploring:
- What does programming look like with intelligent compilation?
- How should intent be structured?
- What are the patterns in problem descriptions?
- Can this scale to complex systems?
Ideas and feedback welcome.
License
MIT
Tagline
"The first compiler that compiles ideas into code."
From the makers of DBBasic - because simple is better.