Ramble Overview
AI-powered structured field extraction from unstructured text. A configurable GUI tool that lets users "ramble" about an idea and extracts structured fields using AI.
Project Links
| Resource | URL |
|---|---|
| Git Repository | https://gitea.brrd.tech/rob/ramble |
| Local Path | ~/PycharmProjects/ramble |
Core Concept
Ramble solves the problem of capturing ideas in a structured format. Instead of filling out rigid forms, you describe what you want in natural language, and AI extracts the structured data.
┌─────────────────────────────────────────────────────────────────┐
│ Ramble │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ "I want a feature that lets users export their data │ │
│ │ to CSV format. It should support filtering by date │ │
│ │ and include all fields. Maybe add PDF export too." │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ AI Extraction │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ { │ │
│ │ "title": "Data Export Feature", │ │
│ │ "type": "feature", │ │
│ │ "formats": ["CSV", "PDF"], │ │
│ │ "filters": ["date"], │ │
│ │ "scope": "all fields" │ │
│ │ } │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Key Features
| Feature | Description |
|---|---|
| Free-form Input | Type naturally without structure constraints |
| AI Extraction | Multiple providers (Claude, Codex, Gemini) |
| Configurable Fields | Define what fields to extract |
| Field Locking | Lock fields you've refined for re-extraction |
| PlantUML Diagrams | Auto-generate diagrams from descriptions |
| Headless Mode | CLI usage without GUI |
| Programmatic API | Import and use in Python scripts |
Tech Stack
- Python 3.10+
- PySide6 - Cross-platform GUI
- Multiple AI Providers - Claude, Codex, Gemini, mock
- PlantUML - Diagram generation
Use Cases
- Feature Requests: Ramble about a feature, get structured spec
- Bug Reports: Describe issue, extract steps/expected/actual
- Meeting Notes: Ramble about discussion, extract action items
- Documentation: Describe concept, get structured outline
Integration
Ramble integrates with CascadingDev to provide a user-friendly way to create feature requests that feed into the discussion workflow.
# Standalone usage
ramble
# Integrated with CascadingDev
cascading ramble # Opens GUI, saves to discussions/
Quick Start
# Install
cd ~/PycharmProjects/ramble
pip install -e .
# Run GUI
ramble
# Headless mode
echo "I want a dark mode toggle" | ramble --headless --fields title,type,priority