Release v0.1

Release v0.1: AI Story Generation Suite Launch! 🎉

We are thrilled to announce the initial release of the AI Story Generation Suite! This collection of Python scripts empowers you to bring your creative visions to life, generating unique story ideas and crafting complete narratives using the power of Large Language Models via the Nebius AI Studio API (featuring Microsoft's phi-4 model).

Whether you're brainstorming your next novel, looking for short story inspiration, or exploring AI-driven creativity, this suite provides a flexible workflow from concept to completion.

✨ Key Features:

• Brainstorming Powerhouse (idea_generator.py):
  • Generate multiple distinct story proposals (title, prompt, setting, genre, word count).
  • Specify desired genres (Sci-Fi, Fantasy, Mystery, etc.) and the number of ideas needed.
  • Supports generating ideas in German (de) and English (en).
  • Optionally save all generated ideas automatically as .txt files for later review.
• Intelligent Story Crafting (story_generator.py):
  • Takes a selected idea (or manually provided details) and writes a full story.
  • Chapter Mode: Automatically structures longer stories (>3500 words by default) into chapters, generating a plot outline first for better coherence and managing LLM context.
  • Utilizes detailed, quality-focused prompts to guide the LLM towards better narrative flow, style consistency, and "show, don't tell" techniques.
  • Supports writing stories in German (Deutsch) and English (Englisch).
  • Saves the final story (and chapter outlines) as .txt files.
• Orchestrated Workflow (app.py):
  • Provides a seamless command-line interface to run the full idea-to-story process.
  • Generate ideas -> Interactively select one (or choose randomly) -> Generate the full story.
• Flexible Usage: Run the main app.py for the full experience or use idea_generator.py and story_generator.py independently.
• Easy Configuration: Set your Nebius API key via a .env file or command-line arguments.
• Extensibility: Designed with OpenAI compatibility in mind, allowing potential adaptation to other LLM services.

🚀 Live Demo:

Experience the Story Generator in action: https://suenkler-ai.de/story-generator

🔧 Getting Started:

1. Prerequisites: Python 3.7+, Nebius AI Studio Account & API Key.
2. Installation: Clone the repository and install dependencies:

   git clone <your-repo-url>
   cd <your-repo-directory>
   pip install -r requirements.txt

3. Configuration: Create a .env file in the project root and add NEBIUS_API_KEY="YOUR_KEY_HERE".
4. Usage: Run the main application:

   # Example: Generate 3 German Sci-Fi ideas and pick one to write
   python app.py --lang de --genres "Science Fiction" --count 3

   (See the README.md for detailed options for app.py, idea_generator.py, and story_generator.py.)

📝 Note:

AI-generated content quality can vary. Experiment with genres, prompts, and potentially different models (if supported) for best results.

🙏 Acknowledgements:

• Powered by the phi-4 model by Microsoft.
• Utilizes the Nebius AI Studio API.

We hope you find this suite useful for your creative endeavors! Please report any issues or suggestions via the GitHub repository issues tracker.