Disclaimer / Notes:

• This project is not affiliated with or endorsed by n8n.io. "n8n" is a trademark of n8n GmbH.
• This is a proof of concept / research project, not production-ready software.
• This codebase was created using Claude Code.

AI-powered n8n workflow generator. Describe what you want in natural language, and faux.ts generates executable n8n workflows.

1. TypeScript API generated from n8n's 400+ node descriptions (3,000+ function signatures)
2. LLM writes code against these types
3. JS Proxy intercepts each call and builds the workflow graph

Function calls become nodes, data flow becomes connections. See the blog post for details.

# Build the image
docker build -t fauxts .

# Run with required environment variables
docker run -p 3000:3000 \
  -e OPENAI_API_KEY=your-openai-api-key \
  fauxts

Open http://localhost:3000 in your browser.

To enable the "Deploy to n8n" button, add N8N_URL and N8N_API_KEY to your environment variables (see table above).

• Bun >= 1.0

# Install dependencies
bun install

# Create .env file
cp .env.example .env
# Edit .env with your API keys

# Download n8n node definitions from npm (required for type generation)
bun run download-nodes          # default version (1.81.0)
bun run download-nodes 1.85.0   # or a specific version

# Generate TypeScript type definitions
bun run generate-types

# Run the web interface (with hot reload)
bun run dev

• /packages - Core functionality packages
  • core - Main orchestrator and configuration
  • ai-prompt-engine - AI prompting, node classification, code generation
  • script-mapper - Maps TypeScript DSL to n8n workflows
  • script-validator - TypeScript AST validation
  • type-generator - Generates TypeScript definitions from n8n nodes
  • n8n-client - n8n API client
  • llm - OpenAI LLM abstraction with streaming
  • tracing - Observability
• /apps - Applications
  • web - Web interface
  • cli - Command-line interface

MIT