GroqTales

AI-Powered Web3 Storytelling Platform

Create, share, and own AI-generated stories and comics as NFTs on the Monad blockchain.

What is GroqTales?

GroqTales is an open-source, AI-powered Web3 storytelling platform. Writers and artists can generate immersive narratives or comic-style stories using Groq AI, then mint and trade them as NFTs on the Monad blockchain. With a focus on ownership, authenticity, and community, GroqTales bridges the world of creative writing, generative AI, and decentralized technology.

---

Features

• AI-Driven Story & Comic Generation
  Use Groq AI to generate stories or comic panel outlines by specifying title, genre, setting, characters, and themes. Both text and comic formats are supported.
• NFT Minting on Monad Blockchain
  Seamlessly mint your stories as NFTs on Monad (Testnet live, Mainnet coming soon). Each NFT proves authenticity, ownership, and collectibility.
• Community Gallery
  Publish your stories publicly, browse the gallery, and interact with other creators. Stories can be shared freely or as NFTs.
• Customizable Prompts & Creativity Levels
  Fine-tune AI output by adjusting prompts, genres, outlines, and creativity settings to match your vision.
• Wallet Integration
  Connect with MetaMask, WalletConnect, or Ledger for secure publishing and minting. Wallet is required for NFT actions.
• Real-Time Story Streaming
  Watch your story unfold in real-time as Groq AI generates each segment.
• Mobile-Friendly & Responsive UI
  Built with modern web technologies for a seamless experience on any device.
• Extensible & Open Source
  Modular codebase with clear separation of frontend, backend, and smart contract logic. Contributions are welcome!

---

Tech Stack

• Frontend: Next.js, React, TailwindCSS, shadcn/ui
• Backend: Node.js, API Routes
• AI: Groq API (story generation), Unsplash API (optional visuals)
• Blockchain: Monad SDK, Solidity Smart Contracts
• Database: MongoDB
• Hosting: Vercel

---

Quick Start

git clone https://github.com/Drago-03/GroqTales
cd GroqTales
npm install
cp .env.example .env.local
# Add GROQ_API_KEY, UNSPLASH key, Monad network if needed
npm run dev

1. Visit http://localhost:3000
2. Connect your wallet (optional; required for minting/publishing)
3. Generate your story → Publish or Mint as NFT

See the Wiki for configuration, environment variables, and deployment details.

---

For Developers

• Folder Structure:

  • /app – Next.js application (pages, UI, routes)
  • /components – Reusable React components
  • /contracts – Solidity smart contracts for NFT minting
  • /lib – Utility functions and API integrations
  • /public – Static assets
  • /test and /tests – Test scripts and sample data
  • /scripts – Automation and deployment scripts

• Environment Variables:

  • GROQ_API_KEY – Your Groq AI API key
  • UNSPLASH_API_KEY – (Optional) for placeholder visuals
  • MONAD_RPC_URL – Monad blockchain RPC endpoint

• Smart Contract Deployment:

  • Contracts are written in Solidity and can be deployed to Monad Testnet/Mainnet.
  • See /contracts and /scripts for deployment instructions.

• Extending AI Models:

  • AI logic is modular—add support for new models or prompt types in /lib and /components.

• Testing:

  • Frontend: Use Jest/React Testing Library.
  • Smart Contracts: Use Hardhat/Foundry for Solidity tests.

• Contributions:

  • Issues are tagged by difficulty, area, and technology for easy onboarding.
  • Please read CONTRIBUTING.md and CONTRIBUTORS.md before submitting PRs.

---

🤝 Contributing

GroqTales is community-powered!
We welcome all contributions—whether you're a developer, designer, writer, or blockchain enthusiast.

How You Can Help:

• Tackle issues labeled good first issue (great for newcomers)
• Enhance story-generation logic, outlines, or UI design
• Add support for new AI models or blockchains
• Improve UX (dark mode, mobile layout, galleries)
• Optimize NFT metadata or IPFS workflows
• Write or improve documentation and tests

What’s in It for You:

• Build your open-source portfolio
• Feature your work in the contributors section
• Community recognition and GitHub Sponsors eligibility

See CONTRIBUTING.md for guidelines.

---

Roadmap

• AI visuals: Integrate Stable Diffusion/DALL·E for comic panels
• Multilingual story generation
• Native marketplace for story NFTs
• Enhanced wallet security & decentralized data storage
• Mobile app support
• More blockchain integrations

---

Contributors

We value every contribution! Please read our CONTRIBUTORS.md file before making your first contribution to understand our guidelines and recognition process.

Project Contributors

Thanks to these amazing people for making GroqTales better!

---

Documentation & Architecture

Core Documentation

• Architecture Overview: ARCHITECTURE.md - Comprehensive system design and technical architecture
• Project Wiki: GitHub Wiki - Detailed guides and documentation
• API Documentation: Wiki/API - Backend API reference
• Smart Contracts: Wiki/Blockchain - Contract documentation

System Architecture

• Frontend Architecture: ARCHITECTURE.md#frontend - Next.js application structure
• Backend Architecture: ARCHITECTURE.md#backend - API and service design
• Blockchain Integration: ARCHITECTURE.md#blockchain - Web3 and smart contract integration
• AI Integration: ARCHITECTURE.md#ai - Groq AI implementation
• System Diagrams: ARCHITECTURE.md#diagrams - Mermaid flowcharts and architecture diagrams

Development Resources

• Setup Guide: Wiki/Development-Setup
• Contributing: CONTRIBUTING.md - How to contribute to the project
• Code of Conduct: CODE_OF_CONDUCT.md - Community guidelines
• Security Policy: SECURITY.md - Security practices and vulnerability reporting

---

Resources

• Website: groqtales.xyz
• Docs: Wiki
• Community Hub: GitHub Discussions
• Discord Support: Join our Discord

---

License

Released under the MIT License.

---

Security

For vulnerabilities or security-related issues, please refer to SECURITY.md.

---

Note

GroqTales currently operates on Monad Testnet for NFT minting. Mainnet support coming soon—stay tuned!

---

Support the project and share it with others.