NeuroForge User Guide

Welcome to NeuroForge — the world's first AI Battle Arena. A platform designed to help you compare, analyze, and challenge the world's most advanced AI models head-to-head in real time.

Whether you're an AI researcher, prompt engineer, or just a curious mind exploring how GPT, Claude, and Gemini think differently, NeuroForge turns model comparison into a visual, interactive experience.

How It Works

When you enter a prompt in the input box, NeuroForge dispatches it to three AI models in parallel — typically GPT-4o, Claude Opus, and Gemini 2.5.

Each model's reply is collected and displayed side-by-side so you can immediately see how their reasoning, tone, and structure differ.

Automatic Scoring System

Every response is analyzed by NeuroForge's Scoring Engine, which evaluates six aspects of quality:

• Success – Did the model produce a valid, coherent response without errors?
• Speed – How fast did it generate its output relative to others?
• Completeness – Did it fully address all aspects of your question?
• Accuracy – Are the facts correct and logically consistent?
• Readability – How natural and clear is the text to read?
• Structure – Does it format and present the answer well?

Each metric contributes to a total score out of 100, and the top performer is displayed as the Round Winner with an explanation of why it won.

Exploring the Interface

The Dashboard Layout

When you log in to NeuroForge, you'll land in your main dashboard. At the top of the screen, you'll find the NeuroForge header bar, which shows your remaining prompts, lets you open the Settings panel, and provides Refresh and Logout options.

Dashboard Overview

The sidebar on the left acts as your thread manager — this is where all your conversations live. Each thread represents an ongoing "battle" or conversation between the models.

Thread Management Features:

• Create a new thread using the + New button
• Rename threads directly by clicking their title
• Delete threads you no longer need
• Revisit older threads to analyze how the models performed in the past

Submitting a Prompt

Let's say you create a new thread called "Debate on Quantum Consciousness". You enter your prompt:

"Explain whether quantum mechanics could play a role in human consciousness."

Hit Continue Battle, and the real magic begins.

All three AI models — GPT, Claude, and Gemini — receive your question at the same moment. They start "thinking" in parallel, and when they finish, their responses appear in neatly designed cards side-by-side.

Response Card Details:

• Model name and chosen personality
• Response time (in milliseconds)
• Tokens used
• Total word count
• Calculated score out of 100

A golden banner appears at the top announcing the winner and summarizing what made it stand out:

Response Interactions

Each model's response isn't just static text — you can interact with it:

Response Cards Interaction

Going over a response, you'll find several small icons in the top-right corner of its card:

• 🔍 Analyze – Triggers an "analysis round" where the other two models critique the selected response and propose improvements
• ⛶ Expand – Opens the full text in a centered modal for distraction-free reading and copying
• 📋 Copy – Instantly copies the entire response to your clipboard

Analysis & Tournament Mode

When you click Analyze, the selected model's response is critiqued by the remaining two models. They evaluate it, point out flaws, and attempt to provide a better version of the answer.

Tournament Disqualification

This results in one model being disqualified while the others advance. You can keep analyzing until only one model remains — the tournament winner.

Thread History & Round Statistics

Every thread retains its full conversation history:

Thread History

Each round within a thread can be expanded or collapsed to review:

• The models' responses for that round
• The score breakdown for each AI
• The winner banner and reasoning

The yellow labels on the right showcase round winner and tournament winner

Settings

Clicking the Settings button in the top bar opens a detailed configuration panel:

Settings Configurations

AI Models

The AI Models section allows you to configure which model versions and personalities each AI agent uses during battles. This is where you determine how GPT, Claude, and Gemini will behave and which specific engines power their responses.

Selecting Personalities

Each agent (GPT, Claude, Gemini) lets you choose from a list of built-in personalities or assign default behavior matching the base model.

Personalities modify tonal behavior, structure, and approach — and can dramatically influence tournament results.

Selecting Models

You may choose from any model version you have enabled in your backend:

• GPT: 4o Mini, 4o, 4.1, 4.1 Mini, 5, 5 Mini, 5 Nano
• Claude: Haiku 3, Sonnet 4, Sonnet 4.5, Opus 4, Opus 4.1
• Gemini: 2.5 Flash, 2.5 Flash-Lite

Scoring

The Scoring tab allows full customization of how NeuroForge grades model responses. This is where you tune the competitive engine itself — adjusting weight multipliers, thresholds, scoring behavior, and more.

Fully Customizable Scoring Engine

Adjusting Scoring Weights

You can modify the importance of each evaluation criterion:

• Success – response validity and overall correctness
• Speed – reply time vs competitors
• Completeness – coverage of all requested information
• Accuracy – factual consistency and reasoning quality
• Readability – clarity and natural flow
• Structure – formatting, organization, and visual clarity

Each weight directly contributes to the final 100-point score.

Threshold Controls

You can define minimum acceptable values before a model loses additional points. Examples:

• Minimum speed threshold (slow replies get penalties)
• Minimum completeness (incomplete reasoning is penalized)
• Error detection rules (JSON error, hallucination signs, etc.)

Custom Personas

The Custom Personas tab enables creation of up to 5 custom personality profiles. These personas allow deep customization of model behavior and can be assigned globally or to individual agents.

Create and Assign Custom Personas

Create a Persona

Each persona includes three fields:

Assigning Personas

You can bind each persona to:

• All agents — GPT, Claude, and Gemini at once
• Individual agents — for asymmetric battles

Forge Memory

Forge Memory is NeuroForge's intelligent performance tracking system. It analyzes your battle history to identify which AI models excel in different types of tasks, providing personalized recommendations based on your actual usage patterns.

Forge Memory - AI Performance Analysis Dashboard

How Forge Memory Works

Every prompt you submit is automatically categorized into one of several task types:

• Coding & Programming - Code generation, debugging, script writing, technical implementations
• Creative Writing - Stories, poems, essays, marketing copy, narrative content
• Analysis & Research - Data analysis, comparisons, evaluations, research summaries
• General Knowledge - Q&A, explanations, definitions, educational content
• Professional & Business - Emails, reports, proposals, business communications
• Technical & Scientific - Scientific explanations, technical documentation, specialized knowledge

Performance Metrics Tracked

For each category, Forge Memory tracks:

AI Recommendations

Based on your historical data, Forge Memory provides actionable recommendations:

• Best Model per Category - Which AI consistently performs best for each task type
• Strengths & Weaknesses - Detailed breakdown of where each model excels or struggles
• Usage Patterns - Insights into your most common prompt categories

Costs

The Costs tab provides detailed insights into your token consumption and estimated API costs. This helps you understand how your AI usage translates into actual resource consumption.

Costs Overview

Token Usage Tracking

The Costs tab displays token consumption broken down by:

• Mode - Separate tracking for Solo Mode vs Tournament Mode
• Agent - Per-model breakdown (GPT, Claude, Gemini)
• Direction - Input tokens (your prompts) vs Output tokens (AI responses)

Understanding Token Costs

Different AI models have different pricing per million tokens. The Costs tab calculates estimated costs based on:

Cost Display

The Costs tab shows:

• Total Tokens - Combined input + output tokens across all usage
• Estimated Cost - Calculated cost in USD based on actual token usage and current pricing
• Mode Breakdown - Solo vs Tournament consumption comparison
• Agent Breakdown - Which models are consuming the most tokens

Auto-Tournament Mode

Auto-Tournament is NeuroForge's hands-free competitive mode. Instead of manually analyzing responses and eliminating models one by one, Auto-Tournament runs the entire 3-round elimination process automatically.

Starting an Auto-Tournament

How Auto-Tournament Works

When you enable Auto-Tournament and submit a prompt, NeuroForge executes the following sequence automatically:

1. Round 1 - Initial Battle: All three models (GPT, Claude, Gemini) respond to your prompt simultaneously
2. Automatic Analysis: The system evaluates all responses and identifies the lowest scorer
3. First Elimination: The weakest model is eliminated from the tournament
4. Round 2 - Refinement: The remaining two models analyze and critique each other's responses
5. Second Elimination: The weaker of the two is eliminated
6. Championship: The surviving model delivers its final, battle-hardened response

Auto-Tournament Progress Indicator

Tournament Progress Display

During the tournament, you'll see a real-time progress indicator showing:

• Current round number and description
• Which models are still competing
• Elimination announcements as they happen
• Final winner declaration

Tournament Results

Once complete, the Tournament Results panel displays:

• Tournament Winner Banner - Celebratory announcement of the champion
• Elimination Order - Visual timeline showing which model was eliminated in each round
• Evolution View - Score progression chart (see below)
• Battle-Hardened Final Response - The winning model's refined answer
• Round-by-Round Breakdown - Expandable details for each round

Parallel Universes

Parallel Universes is NeuroForge's advanced multi-tournament feature. It runs 3 complete Auto-Tournaments simultaneously, giving you multiple perspectives on the same prompt and statistically significant results.

Parallel Universes - Triple Tournament Mode

Why Parallel Universes?

AI responses can vary due to temperature settings, timing, and inherent randomness. Running a single tournament might crown GPT as the winner, while another run could favor Claude. Parallel Universes solves this by:

• Running 3 independent tournaments on the same prompt
• Aggregating results across all universes
• Identifying consistent winners vs. random fluctuations
• Providing statistical confidence in the final recommendation

How It Works

1. Enable Parallel Universes in the battle controls
2. Submit your prompt as usual
3. Watch 3 tournaments run simultaneously
4. Review aggregated results showing performance across all universes

Results Aggregation

The Parallel Universes results panel shows:

• Universe-by-Universe Winners - Which model won each tournament
• Consistency Score - How often the same model won across universes
• Best Response Selection - The highest-scoring response from all universes
• Individual Universe Details - Expandable breakdown of each tournament

Evolution View

Evolution View is a visual representation of how model scores change throughout a tournament. It provides an intuitive, at-a-glance understanding of the competitive dynamics between AI models.

Evolution View - Score Progression Visualization

Reading the Evolution View

The Evolution View displays horizontal progress bars for each model across all tournament rounds:

Insights from Evolution View

The Evolution View helps you understand:

• Score Trends - Did models improve or decline as the tournament progressed?
• Competitive Gap - How close were the scores between models?
• Elimination Pattern - Which model was weakest initially vs. later rounds?
• Winner Consistency - Did the winner dominate from the start or come from behind?

File Attachments

File Attachments enable you to upload images, code files, documents, and data for AI analysis. All three models (GPT, Claude, and Gemini) can analyze your attachments and provide text-based insights.

File Attachments - Upload Interface

Supported File Types

NeuroForge supports a wide variety of file types organized into categories:

📷 Images (5MB max each)

• JPEG/JPG - Standard photos and images
• PNG - Screenshots, graphics with transparency
• GIF - Animated or static graphics
• WebP - Modern web image format

All models can analyze images visually. GPT uses low-detail mode (~85 tokens per image) for efficient processing.

📄 Documents (10MB max)

• PDF - Documents, reports, papers (Claude and Gemini process natively)

💻 Code Files (50KB max each)

Upload source code for review, debugging, or explanation:

• JavaScript/TypeScript - .js, .jsx, .ts, .tsx
• Python - .py
• Java - .java
• C/C++ - .c, .cpp, .cc, .h, .hpp
• Go - .go
• Rust - .rs
• Ruby - .rb
• PHP - .php
• Swift/Kotlin/Scala - .swift, .kt, .scala
• SQL - .sql
• Shell Scripts - .sh, .bash
• Web - .html, .htm, .css, .scss, .sass, .less

📋 Config & Data Files (50-100KB max)

• JSON - Configuration, API responses (100KB max)
• YAML - Docker, CI/CD configs (100KB max)
• XML - Data interchange, configs (100KB max)
• CSV - Spreadsheet data (50KB max)
• TXT - Plain text files (50KB max)
• Markdown - .md documentation (50KB max)
• Log files - .log for debugging (50KB max)

How to Attach Files

1. Click the Attach button near the prompt input
2. Select files from your device, or drag-and-drop into the upload area
3. Preview attached files with their type icons and sizes
4. Remove unwanted files by clicking the X button on each
5. Submit your prompt - files are automatically sent to all three models

File Limits

• Maximum 10 files per submission
• Files are cleared after successful submission
• Unsupported file types are rejected with a clear error message

How Files Are Processed

Different file types are handled optimally by each model:

• Images - Sent as base64-encoded visual content. GPT uses "low detail" mode for token efficiency.
• PDFs - Claude and Gemini process natively as documents. GPT receives extracted text content.
• Code/Text files - Decoded and appended to your prompt with filename headers for context.

Use Cases

• Code Review - Upload your code and ask "What bugs or improvements do you see?"
• Image Analysis - Share screenshots, diagrams, or photos for AI interpretation
• Document Questions - Upload a PDF and ask specific questions about its content
• Data Analysis - Attach CSV files and request insights or transformations
• Config Debugging - Share YAML/JSON configs to troubleshoot deployment issues
• Log Analysis - Upload error logs and ask for root cause analysis

Solo Mode

Solo Mode is NeuroForge's focused 1-on-1 conversation feature. Instead of battling all three AI models simultaneously, Solo Mode lets you have a dedicated conversation with a single AI agent while maintaining the ability to switch between agents mid-conversation.

Solo Mode - User Interface

What is Solo Mode?

While Tournament Mode pits GPT, Claude, and Gemini against each other in competitive battles, Solo Mode provides a more traditional chat experience:

• One AI at a time - Chat with GPT, Claude, or Gemini individually
• Agent switching - Change which AI responds without losing context
• Persistent context - The conversation history is shared, so switching agents maintains continuity
• Separate threads - Solo conversations are stored separately from Tournament battles

Switching Between Modes

To switch between Tournament Mode and Solo Mode:

1. Click the Settings button in the header
2. Navigate to the General tab
3. Select your preferred View Mode: Tournament (Side-by-Side) or Solo (Individual)
4. Close the Settings modal - the interface will update immediately

Using Solo Mode

Once in Solo Mode:

1. Select an Agent - Use the agent selector dropdown next to the send button to choose GPT, Claude, or Gemini
2. Send your prompt - The selected agent will respond
3. Switch agents anytime - Change the dropdown selection before your next message
4. Continue the conversation - The new agent will have access to the full conversation history

Agent Indicator

Each response in Solo Mode shows which agent generated it, so you can always tell who said what as you switch between models during a conversation.

Scoring in Solo Mode

Even in Solo Mode, each response receives a quality score. This helps you evaluate the AI's performance on individual prompts, even without direct competition.

File Attachments in Solo Mode

Solo Mode fully supports file attachments. Upload images, code, or documents just like in Tournament Mode - the selected agent will analyze them and respond accordingly.

Agent Fallback

If your selected agent fails to respond (due to rate limits or errors), Solo Mode automatically falls back to another available agent. You'll see a notice indicating which agent was requested vs. which actually responded.

When to Use Solo Mode

• Extended conversations - When you need a deep, focused dialogue on a topic
• Agent preferences - When you know which AI works best for your use case
• Context testing - Compare how different agents handle the same conversation history
• Prompt efficiency - 1 prompt per message instead of 1 prompt for 3 models

Summarize & Continue

Summarize & Continue is a Solo Mode feature that lets you overcome thread length limits by creating a new thread with a compressed summary of your conversation.

Summarize & Continue Option

Why Summarize?

Each Solo thread has a maximum message limit (typically 100 messages). When you approach this limit, you'll see a warning indicator. Instead of losing your conversation context, Summarize & Continue:

• Creates a condensed summary of your entire conversation
• Opens a new thread starting with that summary
• Preserves essential context while freeing up space for more messages

How It Works

1. When your thread approaches the message limit, a Summarize & Continue button appears
2. Click the button to open the summarization modal
3. Choose which AI should generate the summary (GPT, Claude, or Gemini)
4. Click Summarize to create the summary
5. A new thread is created titled "Continued: [Original Title]"
6. The AI's summary becomes the starting point for your new thread

Thread Limit Indicators

Solo Mode displays visual indicators as you approach the limit:

• Warning (90+ messages) - Orange indicator suggesting you consider summarizing
• Critical (100 messages) - Red indicator when you've reached the limit

Error Handling

NeuroForge handles errors gracefully. You'll always receive a clear message about what went wrong — no cryptic API dumps or console gibberish.

Common Errors:

• Input too long: Message appears instantly, and your prompt isn't consumed
• Model timeout: "⚠️ Model exceeded maximum response length or time limit"
• Prompt balance depleted: Prevented from submitting new prompts.

Security & Authentication

Access to NeuroForge is managed through secure JWT-based tokens. Each token carries your usage limits and permissions.

• Tokens can expire or be reset by administrators
• HTTPS end-to-end encryption
• Input sanitization to prevent injection attacks
• Strict separation between user and admin panels

Example Workflow

Let's walk through a complete example:

1. You log in with your token and see your Welcome Dashboard, confirming your current prompt balance
2. You create a thread titled "Explain relativity like a pirate"
3. You type your prompt and click Start/Continue Battle
4. Within seconds, GPT, Claude, and Gemini all respond — one serious, one comedic, one overly poetic
5. NeuroForge scores each and declares a winner
6. You click Analyze on Gemini's overly poetic response — Claude and GPT critique it mercilessly, disqualifying Gemini
7. You analyze one more time,this time on Claude, disqualifying him and GPT emerges as the final winner
8. Three prompt credits consumed, dozens of insights gained

For Developers & Self-Hosting

If you deploy NeuroForge yourself, you can:

• Host the backend on Node.js/Express with MongoDB
• Build the frontend with React
• Control rate limits, scoring weights, and model endpoints through environment variables
• Integrate your own OpenAI, Anthropic, or Google API keys

Latest Changelog

The latest update introduces major improvements across settings, scoring, customization, performance, and the overall battle experience. This changelog highlights the most recent version updates.

Version 1.8.0 (Latest)

Below is a summary of all new features, fixes, and optimizations available in the latest version (v1.8.0) release:

# 🧪 NeuroForge v1.8.0 – Latest Patch Summary

## 🚀 Major New Features

### Solo Mode - Focused 1-on-1 Conversations
• New conversation mode for dedicated single-agent chats
• Agent switching mid-conversation while maintaining full context
• Choose between GPT, Claude, or Gemini for each response
• Separate thread storage - Solo and Tournament threads are completely isolated
• Agent indicator showing which AI generated each response
• Automatic fallback if selected agent fails (with notification)
• Quality scoring for individual responses even without competition

### Costs Tab - Token Usage Tracking
• New Settings tab showing detailed token consumption
• Breakdown by mode (Solo vs Tournament) and agent (GPT, Claude, Gemini)
• Input vs Output token tracking for precise cost analysis
• Estimated cost calculations based on current API pricing
• Helps optimize usage patterns for cost efficiency

### Summarize & Continue - Unlimited Conversations
• Overcome thread message limits (100 messages) in Solo Mode
• AI-generated summary preserves essential conversation context
• Creates new thread with summary as starting point
• Choose which AI generates the summary
• Visual indicators at 90+ messages (warning) and 100 messages (limit)
• Consumes 1 prompt per summarization

### General Settings Tab
• New Settings tab for mode configuration
• Easy toggle between Tournament (Side-by-Side) and Solo (Individual) modes
• Mode switch takes effect immediately without page reload

## 🐞 Bug Fixes
• Fixed input tokens not being tracked in cost calculations
• Fixed Solo Mode input bar collapsing on page refresh
• Fixed file upload in Solo Mode ("n is not a function" error)
• Fixed textarea not shrinking when deleting text
• Fixed thread selection persisting incorrectly when switching modes
• Fixed threads from other mode appearing in sidebar

## ⚡ Performance & Optimization
• Improved textarea auto-resize behavior
• Enhanced mode switching with proper thread clearing
• Better token logging for accurate cost tracking

Version 1.7.0

Below is a summary of all new features, fixes, and optimizations from the v1.7.0 release:

# 🧪 NeuroForge v1.7.0 – Latest Patch Summary

## 🚀 Major New Features

### Forge Memory - AI Performance Intelligence
• Category-based performance tracking across all your battles
• Automatic prompt categorization (Coding, Creative, Analysis, etc.)
• Per-category statistics: Round Wins, Tournament Wins, Win Rate, Avg Score
• AI-powered recommendations for best model per task type
• Historical data analysis with minimum threshold requirements

### Auto-Tournament Mode
• Fully automated 3-round elimination tournaments
• Real-time progress indicator showing current round and eliminations
• Hands-free operation - submit prompt, watch the battle unfold
• Complete results panel with elimination timeline and winner announcement
• Same 3-prompt cost as manual tournaments

### Parallel Universes - Multi-Tournament Analysis
• Run 3 complete Auto-Tournaments simultaneously
• Aggregated results across all universes
• Consistency scoring to identify true best performers
• Statistical confidence for critical decisions
• Best response selection from all tournament runs

### Evolution View - Score Visualization
• Horizontal bar chart showing score progression across rounds
• Color-coded model performance (Green=Winner, Red=Eliminated)
• Crown and skull icons for winner/elimination markers
• Visual storytelling of tournament dynamics
• Integrated into Tournament Results panel

### File Attachments - Multimodal AI Analysis
• Upload images, code, PDFs, and data files for AI analysis
• Support for 30+ file types: images, code (JS, TS, PY, etc.), configs (JSON, YAML), and more
• All three models (GPT, Claude, Gemini) can analyze attachments
• Smart file size limits to stay within token budgets (50KB code, 100KB config, 5MB images)
• Drag-and-drop interface with file previews and type icons
• Works with Manual Mode, Auto-Tournament, and Parallel Universes
• GPT uses low-detail mode for images (~85 tokens vs ~25k tokens)
• Gemini includes automatic retry with exponential backoff for rate limits

## 🐞 Bug Fixes
• Fixed crash in Tournament Results when elimination data was undefined
• Fixed round winner incorrectly showing eliminated models
• Fixed Gemini displaying as "1.5 Flash" instead of correct version
• Fixed Forge Memory category detection for coding/script prompts
• Fixed failed API responses not being treated as disqualifications
• Fixed tournament wins not counting properly in statistics

## ⚡ Performance & Optimization
• Improved category detection with priority-based pattern matching
• Optimized model name resolution with simplified friendly names
• Enhanced error handling for API quota errors

Version 1.6.0

Below is a summary of features, fixes, and optimizations from the v1.6.0 release:

# 🧪 NeuroForge v1.6.0 – Patch Summary

## 🚀 Features
• Overhauled Settings Modal → redesigned AI Agents tab for cleaner navigation.
• New "Scoring" system with full user-configurable weight sliders:
    ├─ Adjust Success Weight
    ├─ Adjust Speed Weight
    ├─ Adjust Completeness Weight
    ├─ Adjust Accuracy Weight
    ├─ Adjust Readability Weight
    └─ Adjust Structure Weight
• Added Scoring Presets (Balanced, Accuracy-Focused, Creative, Speed-First).
• Import/Export scoring configurations via JSON.
• Added guidance explaining score computation & how analysis rounds work.
• Added "Personas" tab → users can create up to 5 custom personas:
    ├─ Assign persona to all agents or individual agents
    ├─ Instantly available in AI Models tab after creation
    └─ Persona instruction limit: 200 words (performance-optimized)
• New "Statistics" tab:
    ├─ Shows Global Round Wins + Tournament Wins across all threads
    ├─ Thread-level statistics now display per-thread win data
    └─ Deleting a thread auto-updates global stats
• History view updated to show Tournament Winner label (not only Round Winner)
• Added "Caveats" Modal explaining app limitations, model behaviors & expected quirks


## 🐞 Bug Fixes
• Fixed Global Statistics not updating correctly after thread deletion.
• Fixed API rate-limit issue causing logout/login failures.
• Fixed inconsistent personality dropdown rendering in Settings.
• Fixed disqualified agents in History showing API errors instead of proper disqualification cards.
• Fixed multiple prompt-refund edge cases where a prompt was not refunded when all 3 models failed.
• Fixed several UI inconsistencies and minor logic errors.


## 📱 Responsive Fixes
• Fixed navigation overlap issues on smaller screens.
• Fixed Settings → Personalities tab where inner container wouldn't scroll.
• Fixed header button overflow on narrow devices.
• Applied multiple minor mobile layout improvements.


## ⚡ Performance & Optimization
• Improved API response times across all 3 model providers.
• Optimized built-in personality templates to use fewer tokens per request.
• Improved Scoring Engine evaluation overhead.

Conclusion

NeuroForge isn't just a testing tool — it's a lens into the behavior of modern language models. It helps you see how models reason differently, where they excel, and where they fail — and it makes that analysis visual, measurable, and even fun.

So go ahead — create your first thread, send your first battle prompt, and watch the AIs fight for your approval.