Core Concepts

Understanding BotWash's key features and principles.

The Car Wash Metaphor

BotWash uses car wash terminology to make text transformation intuitive:

Wash - A complete text transformation
Formula - A wash program (like "Premium Polish" at a car wash)
Operation - Individual cleaning steps (soap, rinse, wax)

Core Principles

1. Democratized Humanization

Users define what "human-like" means through shareable formulas. There's no single "right" way to humanize text - it depends on context, audience, and purpose.

2. Transparency

BotWash always shows what changed. Every transformation includes:

Before/after comparison with diffs
Per-operation breakdown
Metrics showing impact

3. Community First

The community creates, shares, and improves formulas. This creates a marketplace of transformation recipes.

Formulas

What is a Formula?

A formula is a recipe for text transformation. It contains:

Metadata (title, summary, tags)
Ordered list of operations
Version information
Visibility settings

Versioning

Each time you publish changes to a formula, a new version is created with a timestamp-based identifier. This ensures you can always reference and use specific versions of a formula for reproducible results.

Formula Discovery

Find formulas through:

Search by name/description
Filter by tags
Sort by trending, top rated, newest
Browse by category
Recommended formulas

Operations

What is an Operation?

An operation is a single text transformation function. Operations:

Take text input and parameters
Return transformed text
Are deterministic (same input = same output)
Execute independently

Operation Categories

Structure & Flow - Paragraph/sentence organization
Clarity & Simplicity - Readability, conciseness
Tone & Style - Formality, sentiment, voice
Find & Replace - Pattern matching, substitution
Polish & Correctness - Grammar, spelling, punctuation
Numbers & Data - Formatting dates, numbers, units
Format & Markup - HTML/Markdown conversion
Privacy & Safety - PII redaction, profanity filtering
SEO & Web - Meta descriptions, slugs, keywords
Accessibility - Screen reader optimization, plain language

Execution Order

Operations execute sequentially in the order defined. Each operation receives the output of the previous operation. This allows operations to build on each other.

Runs

What is a Run?

A run is a single text transformation. Each run tracks:

Formula and version used
Execution time and status
Metrics (word count, reading level, etc.)

History Retention

All runs are saved in your History with unlimited retention on all plans.

Organizations

Purpose

Organizations enable teams to collaborate on formulas and share resources.

Features

Shared formulas visible to all members
Role-based permissions (Owner, Admin, Member)
Team API keys with scoped permissions
Usage analytics

Roles

Owner - Full control, billing, member management
Editor - Create/edit org formulas, invite members
Viewer - View and use org formulas

API Access

Authentication

API keys are scoped with specific permissions:

runs - Create and view runs
formulas_read - Read formulas
formulas_write - Create/edit formulas

Rate Limiting

Rate limits prevent abuse and ensure fair usage. Limits vary by plan and are enforced at the API key level.