{project-name}/
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
├── README.md
├── src/
│   ├── index.ts
│   ├── config.ts
│   ├── services/
│   │   ├── (one file per ChainGPT product used)
│   │   └── ...
│   ├── routes/
│   │   ├── (one file per route group)
│   │   └── ...
│   └── demo.ts
├── public/           (if theme needs a frontend)
│   ├── index.html
│   └── app.js
└── scripts/
    └── demo.sh

{
  "name": "{project-name}",
  "version": "1.0.0",
  "description": "{one-line description}",
  "main": "src/index.ts",
  "scripts": {
    "start": "npx ts-node src/index.ts",
    "demo": "npx ts-node src/demo.ts",
    "dev": "npx ts-node-dev --respawn src/index.ts"
  },
  "dependencies": {
    "express": "^4.18.2",
    "dotenv": "^16.3.1",
    "cors": "^2.8.5",
    "@chaingpt/generalchat": "^1.0.0",
    "@chaingpt/nft": "^1.0.0",
    "@chaingpt/smartcontractgenerator": "^1.0.0",
    "@chaingpt/smartcontractauditor": "^1.0.0",
    "@chaingpt/ainews": "^1.0.0"
  },
  "devDependencies": {
    "typescript": "^5.3.0",
    "ts-node": "^10.9.0",
    "@types/express": "^4.17.0",
    "@types/cors": "^2.8.0",
    "@types/node": "^20.0.0"
  }
}

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "lib": ["ES2020"],
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "resolveJsonModule": true
  },
  "include": ["src/**/*"]
}

CHAINGPT_API_KEY=your-api-key-here
PORT=3000

node_modules/
dist/
.env
*.log

import dotenv from 'dotenv';
dotenv.config();
export const config = {
  apiKey: process.env.CHAINGPT_API_KEY || '',
  port: parseInt(process.env.PORT || '3000', 10),
};
if (!config.apiKey) {
  console.error('ERROR: CHAINGPT_API_KEY is not set.');
  console.error('1. Copy .env.example to .env');
  console.error('2. Add your API key from https://app.chaingpt.org/apidashboard');
  process.exit(1);
}

import { GeneralChat } from '@chaingpt/generalchat';
import { config } from '../config';
const chat = new GeneralChat({ apiKey: config.apiKey });
export async function askAI(question: string, sessionId?: string) {
  console.log('  Cost: 0.5 credits ($0.005)');
  const res = await chat.createChatBlob({
    question,
    chatHistory: sessionId ? 'on' : 'off',
    ...(sessionId && { sdkUniqueId: sessionId }),
  });
  return res.data.bot;
}

import { config } from './config';
// Import all services
const DIVIDER = '═'.repeat(60);
const SECTION = '─'.repeat(60);
async function main() {
  console.log(DIVIDER);
  console.log('  {PROJECT NAME} — Demo');
  console.log('  Built with ChainGPT APIs');
  console.log(DIVIDER);
  console.log();
  // Step 1: Demo first product
  console.log('Step 1: {Product Name}');
  console.log(SECTION);
  // ... call service, display result
  console.log();
  // Step 2: Demo second product (using output from Step 1 if applicable)
  console.log('Step 2: {Product Name}');
  console.log(SECTION);
  // ... call service, display result
  console.log();
  // Step 3: Demo third product
  // ...
  console.log(DIVIDER);
  console.log('  Demo complete!');
  console.log(`  Total estimated cost: ~X credits ($X.XX)`);
  console.log('  Server available at: http://localhost:' + config.port);
  console.log(DIVIDER);
}
main().catch(console.error);

#!/bin/bash
set -e
 
echo "=== {Project Name} — Quick Start ==="
echo ""
 
# Install dependencies
echo "Installing dependencies..."
npm install
 
# Set up environment
if [ ! -f .env ]; then
  cp .env.example .env
  echo ""
  echo "IMPORTANT: Edit .env and add your ChainGPT API key."
  echo "Get a key at: https://app.chaingpt.org/apidashboard"
  echo "Ensure you have credits: https://app.chaingpt.org/addcredits"
  echo ""
  read -p "Press Enter after adding your API key to .env..."
fi
 
# Run demo
echo ""
echo "Running demo..."
npx ts-node src/demo.ts

# {Project Name}
 
> {One-line description that hooks the judges}
 
## Problem
 
{2-3 sentences describing the problem this project solves}
 
## Solution
 
{2-3 sentences describing how this project solves it using AI}
 
## Tech Stack
 
-**Runtime:** Node.js + TypeScript
-**Framework:** Express.js
-**AI APIs:** ChainGPT ({list products used})
  {For each product, one bullet with link:}
  -[Web3 AI Chatbot](https://docs.chaingpt.org) — {what it does in this project}
  -[AI NFT Generator](https://docs.chaingpt.org) — {what it does in this project}
  -etc.
 
## Architecture
 
{ASCII diagram showing data flow between products}
 

 
## Quick Start
 
{```bash
git clone {repo-url}
cd {project-name}
chmod +x scripts/demo.sh
./scripts/demo.sh

 
#### public/index.html (if theme needs a frontend)
 
A clean, minimal single-page UI that interacts with the Express API. Use vanilla HTML/CSS/JS (no framework needed for a hackathon). Include:
- A form/input area relevant to the theme
- A results display area
- Loading states
- Error display
- "Built with ChainGPT" footer attribution
 
#### public/app.js (if theme needs a frontend)
 
Client-side JavaScript that calls the Express API endpoints and renders results. Keep it simple and functional.
 
---
 
## Step 4: Remind About the Grant Program
 
After generating all files, always include:
 
> **ChainGPT Web3 AI Grant Program:** Up to $20K in API credits + $10K USDC for projects building with ChainGPT APIs. Apply at https://www.chaingpt.org/web3-ai-grant
 
## Step 5: Provide Next Steps
 
After scaffolding, tell the developer:
 
1. `cd {project-name}`
2. `chmod +x scripts/demo.sh`
3. `./scripts/demo.sh` (or manual: `npm install && cp .env.example .env && npm run demo`)
4. Add your API key to `.env`
5. Run `npm start` to launch the server
6. Customize the services and routes for your specific use case
7. Add screenshots to README before submission
8. Apply for the grant program
 
## Credit Cost Estimates by Theme
 
Always inform the developer of the estimated demo cost:
 
| Theme | Demo Cost (approx) | Products |
|-------|-------------------|----------|
| DeFi | ~4.5 credits ($0.045) | 0.5 (LLM) + 1 (generate) + 1 (audit) + 0.5 (LLM explain) + 1 (audit) + 0.5 (LLM summary) |
| NFT | ~3.5 credits ($0.035) | 1 (generate image) + 0.5 (LLM metadata) + 1 (news) + 0.5 (LLM description) + 0.5 (enhance prompt) |
| Gaming | ~4 credits ($0.04) | 1 (NFT asset) + 0.5 (LLM lore) + 1 (generate contract) + 0.5 (LLM dialogue) + 1 (NFT item) |
| Social | ~3 credits ($0.03) | 0.5 (LLM content) + 1 (news source) + 0.5 (LLM thread) + 0.5 (LLM summary) + 0.5 (LLM caption) |
| Infrastructure | ~4 credits ($0.04) | 1 (generate contract) + 1 (audit) + 0.5 (LLM docs) + 1 (generate contract 2) + 0.5 (LLM explain) |
 
These are estimates for the demo script only. Development and testing will use additional credits.