Skip to main content

​
Welcome!

This guide will walk you through creating your first argument analysis from start to finish. By the end, you’ll have generated a complete logical blueprint with fallacy detection and social sentiment analysis.
Estimated time: 5-10 minutes

​
Prerequisites

Before you begin, make sure you have:
  • A modern web browser (Chrome, Firefox, Safari, or Edge)
  • An email address for account creation
  • A topic, URL, or text you want to analyze
No technical knowledge required - this is a fully web-based platform.

​
Step 1: Create Your Account

First, you’ll need to create a free account to access the platform.
1

Navigate to Sign Up

Go to the Argument Cartographer homepage and click Sign Up in the top navigation.
2

Enter Your Details

Fill in the registration form:
  • Email address - Your working email
  • Password - At least 8 characters
  • Display name - How you’ll be identified (optional)
3

Verify Email

Check your inbox for a verification email and click the confirmation link.
4

Complete Profile

Return to the platform and you’ll be automatically logged in.
Use a strong, unique password. Your account will store all your analysis history.

​
Step 2: Navigate to the Dashboard

After logging in, you’ll land on the Dashboard - your analysis command center.

​
Dashboard Layout

The dashboard consists of:
  • Analysis Input - Large text area to submit topics, URLs, or text
  • Recent Analyses - Your analysis history
  • Narrative Radar - Trending pre-analyzed topics
  • Quick Stats - Your usage metrics

Dashboard Screenshot

The dashboard features a clean, focused interface with the analysis input front and center.

​
Step 3: Submit Your First Analysis

Now for the exciting part - creating your first argument blueprint!

​
Choose Your Input Type

Enter a controversial topic or question:Good examples:
  • “Should artificial intelligence be regulated?”
  • “Universal basic income pros and cons”
  • “Climate change policy debates”
  • “Cryptocurrency as legal tender”
Tips:
  • Be specific but not too narrow
  • Phrase as a question or statement
  • Avoid yes/no questions when possible

​
Submit for Analysis

1

Enter Your Input

Type or paste your topic, URL, or text into the main input box.
2

Click Analyze

Press the “Generate Analysis” button to start the AI processing.
3

Watch the Progress

You’ll see real-time status updates:
  • 🔍 Searching web sources…
  • 📰 Scraping articles…
  • 🐦 Fetching social sentiment…
  • 🤖 Analyzing arguments…
  • ⚠️ Detecting fallacies…
  • ✅ Generating blueprint…
Analysis typically takes 15-45 seconds depending on topic complexity and source availability.

​
Step 4: Explore Your Analysis

Once processing completes, you’ll see your comprehensive argument blueprint!

​
Analysis Overview

The analysis view consists of three main sections:

Summary Panel

High-level overview with:
  • Neutral summary
  • Credibility score (1-10)
  • Key takeaways
  • “Brutal honest take”

Visualization Area

Interactive argument map with:
  • 6 view modes
  • Clickable nodes
  • Export options
  • Full-screen mode

Social Pulse

Twitter sentiment with:
  • AI-generated summary
  • Top 5 relevant tweets
  • Engagement metrics

​
Understanding the Blueprint

1

Identify the Thesis

The central contention appears at the top in most views. This is the main claim being debated.Example: “Artificial intelligence should be regulated by government agencies”
2

Explore Claims (For)

Green/supporting nodes represent arguments in favor of the thesis.Click any claim to see:
  • Full text
  • Source attribution
  • Supporting evidence
  • Detected fallacies
3

Review Counterclaims (Against)

Red/opposing nodes represent arguments against the thesis.These provide the counter-perspective and rebuttals.
4

Examine Evidence

Evidence nodes (smaller, attached to claims) contain:
  • Primary source quotes
  • Statistics and studies
  • Expert opinions
  • URL citations

​
Switch Visualization Modes

Try different views to find what works best for your needs:
Classical argument structure - thesis flows down through reasons and objections to conclusion.Best for: Understanding logical progression
Use the view mode selector in the toolbar to switch between visualizations instantly.

​
Step 5: Review Detected Fallacies

Scroll down to the Fallacy Detection section to see logical errors identified in the source material.

​
Fallacy Card Breakdown

Each fallacy is presented with:
1

Severity & Category

  • Badge: Critical (red), Major (orange), Minor (yellow)
  • Type: Logical, Rhetorical, or Statistical
2

Problematic Text

The exact quote containing the fallacy, highlighted in context.
3

Explanation

Clear description of why this reasoning is flawed.
4

Educational Content

  • Formal definition of the fallacy
  • How to avoid it in your own arguments
  • Example of the fallacy type
5

Suggested Fix

A logically sound rephrasing of the argument.
Click any fallacy card to expand and see full educational details.

​
Step 6: Check Social Pulse

Open the Social Pulse panel (right sidebar) to see public discourse on the topic.

​
What You’ll See

  1. AI Summary - Neutral synthesis of Twitter sentiment and key discussion points
  2. Top Tweets - 5 most relevant/engaging tweets sorted by likes
  3. Author Info - Profile pictures, names, and handles
  4. Engagement - Visual indicators for likes, retweets, replies
The Social Pulse helps you understand how the public is actually discussing the topic, beyond formal news sources.

​
Step 7: Export & Share

Ready to share your findings? Use the export feature!
1

Open Export Modal

Click the Export button in the toolbar (download icon).
2

Choose Format

Select your desired format:
  • PNG - High-quality image (1x, 2x, or 3x resolution)
  • SVG - Scalable vector graphic
  • JSON - Raw data for developers
3

Configure Options

For PNG/SVG:
  • Color mode (Light or Dark)
  • Include background (Yes or No)
  • Resolution (1x, 2x, 3x)
4

Download or Share

  • Download to save to your device
  • Copy to clipboard for quick pasting
  • Share directly to X, LinkedIn, WhatsApp, or Telegram
{
  "blueprint": [
    {
      "id": "thesis-1",
      "type": "thesis",
      "side": "for",
      "content": "AI should be regulated...",
      "source": "https://bbc.com/..."
    }
  ],
  "credibilityScore": 7,
  "fallacies": [...]
}

​
Step 8: Ask Follow-Up Questions

Use the Ask More chat feature to dive deeper into the analysis.

​
How to Use Ask More

1

Open Chat Panel

Click the Ask More button or chat icon in the toolbar.
2

Type Your Question

Ask anything about the analysis:
  • “What’s the strongest evidence against the thesis?”
  • “Explain the straw man fallacy in claim 3”
  • “Which sources are most credible?”
3

Get AI Response

Gemini analyzes your question in context of the full blueprint and provides an informed answer.
Ask More has access to the entire blueprint, all sources, and detected fallacies - it can provide detailed, context-aware answers.

​
Next Steps

​
Explore More Features

Narrative Radar

Browse pre-analyzed trending topics

Visualization Modes

Master all 6 visualization options

Fallacy Detection

Learn to identify logical fallacies

Analysis History

Access and manage past analyses

​
Tips for Better Analyses

The platform works best with topics that have genuine debate and multiple perspectives. Avoid one-sided issues.
“Should AI be regulated?” is better than just “AI”. Specificity helps the system find more relevant sources.
Different visualization modes highlight different aspects of arguments. Try them all!
Click through to original sources to verify context and read full articles.
The AI can clarify confusing claims, explain why something is a fallacy, or provide additional context.

​
Troubleshooting

If analysis exceeds 60 seconds:
  • Check your internet connection
  • Try a simpler topic
  • Refresh the page and try again
If the issue persists, the API services may be experiencing high load.
If the system can’t find sources:
  • Try rephrasing your topic with different keywords
  • Ensure your topic is recent and newsworthy
  • Check that it’s a genuinely debated issue
The system will fall back to AI knowledge with a disclaimer if external APIs fail.
The AI is very sensitive and may occasionally:
  • Flag rhetorical flourishes as fallacies
  • Miss subtle logical errors
  • Misclassify fallacy types
Use the confidence score (0-100%) as a guide. Lower confidence means the AI is less certain.
If export fails:
  • Try a different format (PNG vs SVG)
  • Reduce resolution (3x → 1x)
  • Disable browser extensions that might interfere
  • Use Download instead of Copy to Clipboard

​
Getting Help

If you need assistance:

Documentation

Comprehensive user guides

Common Issues

Troubleshooting reference
Congratulations! You’ve completed your first analysis. Keep exploring and refining your critical thinking skills.

Build docs developers (and LLMs) love

Get started for freeTalk to us