The fastest way to understand what Bigspin can do is to see it work on your own data. This guide takes you through every step — from creating an account to reading your first report. If you have a file of AI conversation transcripts ready, the whole process takes just a few minutes.Documentation Index
Fetch the complete documentation index at: https://docs.bigspin.ai/llms.txt
Use this file to discover all available pages before exploring further.
Sign up or log in
Go to app.bigspin.ai and create an account, or log in if you already have one. After signing in, you land on the Projects page — your central workspace for organizing transcript analysis and accessing reports.
Create a project
Click Create Project in the top-right corner. A modal appears with the following fields:After filling in the details, you can upload transcript files directly in the modal (see the next step), or click Create Project to create an empty project and add files later.
- Name — A short, descriptive label for this project (required).
- Data source type — Choose the domain that best fits your transcripts:
General— Suitable for most AI assistant, support, and chat use cases.AI coding— Optimized for AI coding assistant conversations.
- Description — Optional context about what this project covers.
- Tags — Optional labels to help you organize and filter projects. Type a tag and press Add (or hit Enter) to attach it.
The data source type is locked once you create the project. Choose carefully — you cannot change it later.
Upload your transcripts
Drag and drop your transcript files onto the upload zone, or click it to browse. You can add multiple files at once. Or, you can connect via a data source like LangSmith or Braintrust (scroll down for those instructions).Supported formats: CSV, TSV, JSON, JSONL, Parquet — up to 500 MB per file.Valid roles for turns:
JSONL format (recommended)
Each line in a JSONL file must be a valid JSON object. Include anid, a turns array, and an optional started_at timestamp:user, assistant, human_agent, system, tool.CSV / TSV format
Your file needs these columns (the parser accepts flexible naming):| Column | Required | Accepted names |
|---|---|---|
| Conversation ID | Yes | id |
| Conversation content | Yes | conversation, messages, turns, transcript |
| Conversation name | No | name |
| Timestamp | No | timestamp, started_at, created_at |
Connecting a data source instead
If your traces live in LangSmith or Braintrust, click Data Sources on the Projects page to configure an integration. Once connected, transcripts sync automatically — no file uploads needed. See the Integrations section for setup details.Wait for analysis
After you upload files, Bigspin processes your transcripts automatically. You can track progress directly in the project view. Processing time depends on the number of transcripts — most uploads complete within a few minutes.
You do not need to keep the browser open during processing. Bigspin runs the analysis in the background.
View your first report
Once processing finishes, open your project and navigate to its report. The report surfaces:
- Patterns — Recurring themes and topics across your conversations.
- Issues — Problem areas where your AI’s responses fall short.
- Trends — How quality and topic distribution shift over time.
What’s next
Core concepts
Learn the key ideas behind Bigspin: projects, transcripts, reports, and the improvement cycle.
Connect a data source
Set up LangSmith or Braintrust for continuous, automatic transcript ingestion.
Connect your transcripts
Learn more about supported formats and how to structure your data.
API Reference
Integrate Bigspin into your stack with our Projects and Transcripts APIs.