GitHub - saurabhchalke/EtherTale: EtherTale is an interactive story generation app

EtherTale: Weave Stories Together, Forever 🌿📖🔗

EtherTale is an innovative, decentralized storytelling platform that combines the power of AI-generated narratives with the security and transparency of the Minimal Anti-Collusion Infrastructure (MACI) voting system. With EtherTale, users can collaboratively create immersive, branching storylines by voting on the direction of the tale at each decision point.

This project was built as part of ETHTaipei 2024.

Features ✨

• 🤖 AI-generated story content using advanced language models
• 🔒 Secure and transparent voting with the MACI protocol
• 🌿 Immersive, branching narratives that evolve based on community choices
• 🎨 Sleek, cyberpunk-inspired user interface
• ⚡️ Real-time updates and seamless user experience

How It Works 🛠️

1. 🚀 Users join an EtherTale story and are presented with an AI-generated story snippet.
2. 🤔 At key decision points, users vote on the direction they want the story to take using the MACI protocol.
3. 🗳️ Votes are securely tallied, ensuring privacy and preventing collusion.
4. 🔮 The winning choice is revealed, and the AI continues the story based on the community's decision.
5. 🔄 The process repeats, with users shaping the story at each junction until the tale reaches its conclusion.

Technologies Used 💻

• 🐍 Python: Backend server and AI integration
• 🗳️ MACI: Secure and private voting system
• ⚛️ React: Frontend user interface
• 🌐 Next.js: Server-side rendering and routing
• 💅 Styled Components: CSS-in-JS styling
• 🔌 WebSocket: Real-time communication between server and client

Deployed Contracts 📜

Linea Goerli 🐸

Deployer Address: 0xD936c886BA94BB0b004500E7EDa710194797787B

Optimism Sepolia

Deployer Address: 0xD936c886BA94BB0b004500E7EDa710194797787B

Getting Started 🏁

Clone the repository

git clone https://github.com/saurabhchalke/ethertale.git

Install dependencies

Set up the backend server

cd server
pip install -r requirements.txt

Start the backend server

Start the frontend server

Open your browser and navigate to http://localhost:3000 to start weaving stories with EtherTale!

Contributing 🤝

We welcome contributions from the community! If you'd like to contribute to EtherTale, please follow these steps:

1. Fork the repository
2. Create a new branch for your feature or bug fix
3. Make your changes and commit them with descriptive messages
4. Push your changes to your forked repository
5. Submit a pull request to the main EtherTale repository

License 📜

EtherTale is released under the MIT License.

Acknowledgements 🙏

We would like to thank the following projects and resources that made EtherTale possible:

• MACI - Minimal Anti-Collusion Infrastructure
• OpenAI - AI language models
• Next.js - React framework for server-side rendering and routing
• Styled Components - CSS-in-JS library

Let's weave stories together, forever! 🌿📖🔗