Skip to main content
Use npx create-subconscious-app to quickly scaffold a new project from one of our templates. Each template includes working code, documentation, and best practices.

​
Quick Start

npx create-subconscious-app
The CLI will:
  1. Show you available templates
  2. Let you choose one interactively
  3. Download and set up the project
  4. Provide next steps
You can also specify a template directly: 
npx create-subconscious-app my-agent --example e2b_cli
Or list all available templates: 
npx create-subconscious-app --list

​
Available Templates

E2B CLI Agent

TypeScript • Autonomous agent with secure code execution

Build a developer-first CLI agent that reasons and executes code in isolated E2B cloud sandboxes. Perfect for data analysis, code generation, and automation tasks.

Features: Long-horizon reasoning, secure sandbox execution, file I/O, multi-language support, data science ready

Search Agent CLI

Python • Web research and information gathering

Command-line interface for deep web research with multi-source information gathering. Demonstrates tool-calling and streaming capabilities.

Features: Multi-source research, live thinking feedback, real-time streaming, multiple search providers, automatic citations

Structured Output (TypeScript)

TypeScript • Type-safe agent responses

Get type-safe structured responses from Subconscious agents using Zod schemas. Perfect for building APIs and applications that need predictable data structures.

Features: Zod validation, TypeScript inference, automatic parsing, sentiment analysis example

Structured Output (Python)

Python • Type-safe agent responses

Get type-safe structured responses from Subconscious agents using Pydantic models. Ideal for Python applications requiring validated data structures.

Features: Pydantic validation, automatic type conversion, sentiment analysis example, FastAPI/Django ready

Convex Real-time App

TypeScript (React + Convex) • Full-stack real-time applications

Build a real-time AI todo assistant with instant UI updates. Demonstrates how to integrate Subconscious with Convex for real-time data synchronization.

Features: Real-time WebSocket updates, React frontend, Convex backend, tool calling, database integration

​
Customizing Templates

All templates are fully customizable. After creating a project:
  1. Modify the code - Each template includes well-documented source code
  2. Add tools - Extend functionality by adding custom tools
  3. Change the engine - Switch between different Subconscious engines
  4. Customize the UI - For frontend templates, modify React components

​
Contributing Templates

Have a great example? We’d love to include it! Templates should:
  • Be production-ready or close to it
  • Include clear documentation
  • Follow best practices
  • Be easy to understand and modify
Submit a template →

Quickstart

Get started in 5 minutes

Core Concepts

Learn the fundamentals

Tools

Add custom tools to your agents

Structured Output

Get type-safe responses