# n8ntocode

> Convert n8n workflows to production-ready Python code

n8ntocode is a web application that converts n8n workflow JSON into structured, runnable Python projects. It generates complete project packages including workflow code, configuration, documentation, and AI-agent context files.

## What it does

- Converts n8n workflow JSON to structured Python code using the n8ntocode SDK
- Generates a complete project: workflow.py, config.py, README.md, AGENTS.md, requirements.txt
- Visualizes workflows as interactive node graphs
- Supports 19+ n8n node types: HTTP Request, Webhook, IF/Switch, Code, Google Sheets, Slack, Email, Airtable, PostgreSQL, MySQL, OpenAI, Anthropic, Gemini
- Auto-converts simple JavaScript custom code nodes to Python
- Generates AGENTS.md specifically for AI coding agents to understand and extend the code

## How to use

1. Go to /convert
2. Paste n8n workflow JSON or import from URL
3. Click Convert
4. Download the generated Python project as a ZIP

## AI Agent Integration

The generated AGENTS.md file provides:
- Project structure explanation
- SDK conventions (@step decorator, depends_on, config references)
- How to add new steps
- Which steps need human review
- Full parameter documentation in config.py

AI agents like Claude Code, Cursor, Windsurf, and GitHub Copilot can read AGENTS.md to understand the full codebase and make accurate modifications.

## Pricing

- 1 free conversion per user
- $5 per additional conversion
- No subscription required

## Pages

- / — Landing page with features, pricing, and FAQ
- /convert — Main conversion interface
- /visualize — Interactive workflow visualization
- /dashboard — User conversion history and billing