✨ PlotBuddy ✨

PlotBuddy is an AI-powered creative writing assistant designed to help users of all backgrounds unleash their imagination and craft compelling stories. Whether you’re a seasoned writer or just starting, PlotBuddy guides you through the storytelling process with engaging prompts, genre suggestions, brainstorming support, and instant feedback. By combining the power of conversational AI with an intuitive interface, PlotBuddy makes creative writing accessible, fun, and interactive for everyone. ✍️📚


🚀 Built With

  • Languages:
    🐍 Python (backend), ⚛️ JavaScript (frontend)

  • Frameworks & Libraries:
    ⚡ FastAPI (backend API), ⚛️ React (frontend UI), 🛡️ Pydantic (data validation), 🗝️ dotenv (environment management)

  • Cloud Services:
    ☁️ Google Cloud Run (API hosting), 🗄️ Google Cloud Storage (assets), 🤖 Google AI/Vertex AI (LLM/Gemini integration), 🔥 Firebase (authentication, real-time database, analytics)

  • APIs & Integrations:
    🤖 Google Gemini API (LLM), 🔗 Custom REST APIs (handles chat, story creation, and user interactions)

  • Other Technologies:
    🐳 Docker (containerization), ⚙️ GitHub Actions (CI/CD), 🔒 CORS Middleware (API security)


💡 Inspiration

I wanted to empower everyone—regardless of writing experience—to unleash their creativity and tell amazing stories. With the rise of AI, I saw an opportunity to make storytelling more accessible, fun, and interactive for all ages. PlotBuddy was born from my passion for creative writing and my desire to help users overcome writer’s block, brainstorm new ideas, and bring their stories to life. ✨

🤖 What it does

PlotBuddy is an AI-powered creative writing assistant. Users can:

  • ✍️ Start a new story by choosing a genre, mood, and length.
  • 💡 Get instant inspiration and genre suggestions.
  • 🧠 Brainstorm story ideas with an engaging, conversational AI.
  • 📝 Receive writing tips and answers to common questions.
  • 💬 Seamlessly interact with a friendly chatbot that guides them through the story creation process.

🛠️ How I built it

  • Frontend: Built with React for a responsive, user-friendly interface.
  • Backend: FastAPI powers the API, handling user requests and orchestrating agent responses.
  • AI Integration: Google Gemini (via Vertex AI) provides natural language understanding and creative text generation.
  • Cloud: Deployed on Google Cloud Run for scalability and reliability.
  • Other Tools: Pydantic for data validation, Docker for containerization, and GitHub Actions for CI/CD.

🧗 Challenges I ran into

  • Designing smooth multi-turn conversations between users and the AI.
  • Handling ambiguous or unsupported user requests gracefully.
  • Integrating multiple agents (FAQ, greeting, story, brainstorming) and routing messages intelligently.
  • Ensuring fast, reliable API responses while leveraging cloud-based LLMs.

🏆 Accomplishments that I'm proud of

  • Built a robust, modular agent system that can be extended with new features.
  • Created a friendly, engaging user experience that encourages creativity.
  • Successfully integrated Google Gemini for dynamic, context-aware storytelling.
  • Deployed a full-stack AI application on Google Cloud.

📚 What I learned

  • How to design conversational AI flows that feel natural and helpful.
  • Best practices for orchestrating multiple AI agents and fallback logic.
  • The importance of clear error handling and user guidance in chatbots.
  • How to leverage Google Cloud and Vertex AI for scalable AI applications.

🚀 What's next for PlotBuddy

  • 👤 Add user accounts and story saving/sharing features.
  • 🎭 Expand genre and mood options, including user-defined genres.
  • 🤝 Integrate collaborative story writing and editing.
  • 🧠 Enhance the AI’s ability to remember context and provide richer feedback.
  • 🌍 Launch on more platforms and reach a wider

Built With

  • ai/vertex
  • api
  • cloud
  • cors
  • custom-rest-apis-other-technologies:-docker-(containerization)
  • docker
  • dotenv-(environment-management)-cloud-services:-google-cloud-run-(api-hosting)
  • firebase
  • gemini
  • github
  • github-actions-(ci/cd)
  • javascript-(frontend)-frameworks-&-libraries:-fastapi-(backend-api)
  • pydantic-(data-validation)
  • python
  • react-(frontend-ui)
  • rest
Share this project:

Updates