Skip to main content
The AI Story Generation feature uses Google Gemini AI to create imaginative retellings of biblical narratives. Generate stories with custom perspectives, settings, tones, and lengths while maintaining theological integrity.
AI Story Generation is a premium feature that requires you to be signed in. Stories are generated using AI and subject to rate limiting.

​
Getting Started

Create your first AI-generated story:
1

Sign In

Ensure you’re signed in to your account. Story generation is only available to authenticated users.
2

Navigate to Stories

Go to the Stories section from the main navigation menu.
3

Create Story

Click the “Create Story” button to begin the story generation process.
4

Select Bible Passage

Choose:
  • Bible translation: Which version to base the story on
  • Chapter: The specific chapter you want to reimagine
5

Configure Parameters

Customize your story using the available parameters (detailed below).
6

Generate

Click “Generate Story” and wait while the AI creates your narrative.
Story generation typically takes 10-30 seconds depending on the length and complexity of the passage.

​
Customization Parameters

Control how your story is generated with five key parameters:

​
Title

Give your story a meaningful title:
  • Purpose: Helps you identify and organize your stories
  • Requirement: Must be provided (cannot be empty)
  • Tips: Use descriptive titles like “The Good Samaritan from the Priest’s View” or “Creation Week in Modern Times”

​
Perspective

Choose the narrative point of view:
Tell the story as a participant:
  • “I walked along the road to Jericho…”
  • Experience events through a character’s eyes
  • Deeply personal and immersive
  • Examples: “As Peter, I witnessed…”, “I was the woman at the well…”

Perspective Examples

  • “observer”: Traditional third-person narration
  • “Mary, mother of Jesus”: First-person from Mary’s viewpoint
  • “a Roman soldier”: Experience events from a soldier’s perspective
  • “an angel”: Celestial viewpoint on earthly events

​
Setting

Describe the context or environment for your story: Purpose: Reimagine the biblical narrative in different contexts Examples:
  • Historical accuracy: “First century Judea, traditional setting”
  • Different time period: “Medieval Europe”, “Ancient China”, “Victorian England”
  • Modern setting: “Contemporary New York City”, “Rural farming community”
  • Fictional worlds: “Space station”, “Fantasy kingdom”, “Post-apocalyptic wasteland”
  • Alternative history: “What if it happened in…”
While the setting can be creative, the AI maintains the core theological message and divine actions from the original passage.

​
Tone

Set the emotional or thematic tone:
Contemplative and thoughtful:
  • Deep meditation on themes
  • Slower pacing
  • Emphasis on meaning and significance
  • Good for: Psalms, wisdom literature, teaching passages
More tone options:
  • Inspirational: Motivating and uplifting
  • Solemn: Serious and reverent
  • Joyful: Celebratory and exuberant
  • Dramatic: High tension and emotion

​
Story Length

Control the length of your generated story:
1

Short

~200 words
  • Quick read (1-2 minutes)
  • Focuses on key events
  • Best for simple narratives
  • Faster generation time
2

Medium

~500 words
  • Balanced length (3-5 minutes)
  • Includes more detail and context
  • Good for most passages
  • Recommended default option
3

Long

~1000 words
  • Comprehensive retelling (7-10 minutes)
  • Rich detail and character development
  • Best for complex narratives
  • Longer generation time
Story length is approximate. The AI may adjust slightly based on natural story flow and chapter content.

​
Theological Guidelines

The AI is programmed with strict theological and ethical guidelines:

​
Core Principles

Every generated story adheres to these rules:
  1. Doctrinal Integrity: Core biblical doctrines are never contradicted
  2. Reverence: God and biblical figures are treated with respect
  3. Narrative Consistency: Essential plot points and divine actions are preserved
  4. Appropriate Content: No explicit violence, sexual content, or inappropriate material
  5. Creative Boundaries: Setting and perspective can change, but theological truth remains

What the AI Won't Do

  • Contradict core biblical teachings
  • Disrespect God or biblical figures
  • Invent new theological doctrines
  • Add significant events that change the narrative’s meaning
  • Create inappropriate or offensive content
  • Replace divine intervention with natural explanations

​
What Makes a Good AI Story

The best AI stories:
  • Respect the original: Core message and events are preserved
  • Add creativity: New perspectives and settings bring fresh insights
  • Remain reverent: Maintains appropriate tone for Scripture
  • Engage the reader: Well-written and compelling narrative
  • Provoke thought: Helps you see familiar passages in new ways

​
Viewing Generated Stories

Once your story is generated, you can view and interact with it:

​
Story Display

Desktop experience: 
┌──────────────────┬──────────────────┐
│                  │                  │
│  Original Text   │  Generated Story │
│                  │                  │
│  John 3:1-21     │  The Night Visit │
│                  │                  │
│  (Bible chapter) │  (AI narrative)  │
│                  │                  │
└──────────────────┴──────────────────┘
  • Side-by-side comparison: See the original passage and generated story simultaneously
  • Easy reference: Compare the AI interpretation with Scripture
  • Full chapter context: Original text shows the complete chapter
Mobile experience:
  • Tabbed interface: Switch between “Original” and “Story” tabs
  • Full-screen reading: Maximize space for comfortable reading
  • Easy navigation: Swipe or tap to switch views

​
Story Metadata

Each story displays:
  • Title: Your chosen story title
  • Chapter reference: Which Bible passage inspired it (e.g., “John 3”)
  • Parameters used: Perspective, setting, tone, and length
  • Creation date: When the story was generated
  • Bible translation: Which version was used as the source

​
Rate Limiting

To manage API costs and ensure fair usage, story generation is rate limited:

​
How Rate Limiting Works

  • Per-user limits: Limits are applied to your user account
  • Time-based windows: Limits reset after a specific time period
  • Redis-powered: Uses Redis for fast, accurate rate limit tracking

​
When You Hit the Limit

If you exceed your rate limit:
  1. Error message: You’ll see a clear error explaining the limit
  2. Remaining requests: The message shows how many requests remain
  3. Wait period: Information about when you can generate again
  4. Typical message: “Rate limit exceeded. Try again in a few hours. Remaining requests: 0.”
Rate limits are in place to control costs associated with the Google Gemini API. Be thoughtful about story generation and create stories you’re genuinely interested in.
The exact rate limit (e.g., 5 stories per day, 10 per hour) depends on your deployment configuration. Check with your administrator for specific limits.

​
Managing Your Stories

Organize and maintain your generated stories:

​
Viewing All Stories

Access your story library:
  1. Navigate to Stories: Go to the Stories page
  2. Browse your collection: See all previously generated stories
  3. View details: Click any story to read it again

​
Story List Information

The stories dashboard shows:
  • Story titles: All your generated stories
  • Chapter references: Which Bible passage each is based on
  • Creation date: When each story was generated
  • Quick actions: Read or delete options

​
Deleting Stories

Remove stories you no longer want:
1

Find the Story

Locate the story in your stories list.
2

Click Delete

Click the delete button (typically a trash icon).
3

Confirm

Confirm that you want to permanently delete the story.
Deleted stories cannot be recovered. If you want the same story again, you’ll need to regenerate it (which counts against your rate limit).

​
Best Practices

​
Effective Story Generation

Choose parameters thoughtfully:
  • Match tone to the passage (reflective for wisdom, adventurous for action)
  • Consider perspective carefully (whose viewpoint adds insight?)
  • Use setting creatively but meaningfully
  • Start with medium length, adjust as needed

​
Story Ideas

Creative Story Concepts

  • The Prodigal Son from the father’s perspective (reflective tone)
  • David and Goliath as a modern sports underdog story (inspirational, contemporary setting)
  • The Good Samaritan from the injured man’s viewpoint (first person, dramatic tone)
  • Creation Week as a nature documentary (observer perspective, wonder-filled tone)
  • Paul’s shipwreck as an adventure tale (adventurous tone, detailed setting)

​
Privacy and Storage

Your generated stories are:
  • Private: Only you can see your stories
  • Secure: Stored securely in the Convex database
  • Persistent: Available across all your devices
  • User-linked: Tied to your user account
Stories are stored with all their metadata (parameters, chapter reference, etc.) so you can always see how each story was generated.

​
Limitations and Considerations

​
Technical Limitations

  • Generation time: Stories take 10-30 seconds to generate
  • Rate limits: Limited number of generations per time period
  • AI variability: Each generation is unique; regenerating produces different results
  • Length accuracy: Word counts are approximate targets

​
Content Considerations

  • AI interpretation: Stories are AI-generated interpretations, not Scripture
  • Theological review: Always compare with actual Bible text and trusted commentaries
  • Creative license: Settings and perspectives are creative, not authoritative
  • Educational use: Best used as a supplementary study tool, not primary source
AI-generated stories are creative tools for engagement and perspective-taking. They do not replace careful Bible study, prayer, and sound theological teaching.

​
Next Steps

Combine AI stories with other study features:
  • Read the original passage before generating a story
  • Take notes comparing the story to the original text
  • Save meaningful verses from the source chapter
  • Search for related passages to deepen understanding