StorySparkAI is an open-source platform for AI-powered creative writing, enabling users to generate and explore multiple story variations from a single prompt. It targets writers, creators, and enthusiasts seeking to overcome writer's block and enhance their storytelling through AI assistance. The platform offers a responsive user experience for seamless interaction across devices.

How It Works

The platform leverages advanced AI models to generate unique stories based on user prompts. Its core functionality revolves around prompt-based storytelling, allowing users to input an idea and receive multiple distinct narrative outputs. It also incorporates AI analysis capabilities for story insights, summaries, and critiques, alongside features for bookmarking and revisiting generated stories.

Quick Start & Requirements

• Prerequisites: Node.js 18.18+, npm 9+, MongoDB URI.
• Installation: Clone the repository and run pnpm install at the repo root.
• Environment Setup: Copy .env.example files to .env for both backend and frontend, configuring essential variables like DATABASE_URL, JWT_SECRET, and API keys (OpenAI, Gemini, Unsplash).
• Running Locally: Use pnpm dev for both backend and frontend, or pnpm dev:backend / pnpm dev:frontend separately.
• Admin Seeding: Execute npx ts-node scripts/seed-admin.ts within the backend directory after setting admin credentials in .env.
• Deployment: Vercel deployment is supported for frontend and backend API projects.

Highlighted Details

• AI-Powered Story Generation from single prompts.
• Generation of multiple story variations.
• AI Analysis for story insights, summaries, and critiques.
• Story Bookmarks/History feature.
• Responsive User Interface.

Maintenance & Community

The project is maintained by Roni Sarkar. Contributors are automatically updated from GitHub. No explicit links to community channels (e.g., Discord, Slack) or roadmaps are provided in the README.

Licensing & Compatibility

The project is licensed under the MIT license. This license is permissive and generally allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

Setup requires specific Node.js and npm versions, along with a running MongoDB instance. Functionality relies on external API keys (OpenAI, Gemini, Unsplash), incurring potential costs and external dependencies. The README troubleshooting section highlights potential complexities with Docker, WSL, dependency management, and environment variable configuration, suggesting these may be common setup hurdles. Socket.IO integration has noted limitations on Vercel serverless environments.