convert-to-csv / README.md
Threadbourne's picture
Update README.md
bc07c99 verified
|
Raw
History Blame Contribute Delete
1.4 kB
---
title: Markdown To CSV Converter (for Threadscope)
emoji: 🏢
colorFrom: green
colorTo: green
sdk: gradio
sdk_version: 6.3.0
app_file: app.py
pinned: false
license: mit
short_description: 'Turn .md / .txt into csv '
---
## What this tool does
This tool converts structured chat transcripts written in Markdown or plain text
into a canonical turn-level CSV format suitable for analysis with **Threadscope:
Drift & Hold**.
## Supported transcript format
This converter expects transcripts that use explicit speaker markers, for example:
- 'You said: Hello'
- 'ChatGPT said: Hi there'
Marker strings are configurable in the UI, but the transcript must follow a
consistent “marker → content” pattern.
## Not supported
- Arbitrarily formatted prose
- Chat logs without explicit speaker markers
- Exported HTML or JSON without preprocessing
## Output
The generated CSV includes the following columns:
- `turn`
- `speaker`
- `chars`
- `words`
- `tokens_est` (lightweight estimate)
## How this fits into the Threadbourne lab
This tool is intended as a preprocessing step for use with
**Threadscope: Drift & Hold**, which visualizes long-form interaction dynamics
such as drift, stability, and perturbation response.
## Privacy
Files are processed in-session only and are not stored.
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference