Marianna is an Italian virtual agent designed to share the rich cultural heritage, fascinating history, and captivating legends of Naples, Italy. Through interactive conversations, she brings to life the stories that have shaped Naples, one of the world's most ancient cities.
Try to chat with Marianna and discover her knowledge!
Our virtual guide takes her name from a fascinating piece of Neapolitan history known as "Donna Marianna 'a cap'e Napule" (Donna Marianna, the head of Naples). In the 17th century, a large marble head of a woman was discovered in the Piazza Mercato area. This remarkable find was documented in Carlo Celano's 1692 work "Notizie del bello, dell'antico e del curioso della città di Napoli" (News of the beautiful, the ancient, and the curious of the city of Naples), where it was identified as the head of the mythical Siren Parthenope.
The people of Naples affectionately named this artifact "'a cap'e Napule," and it became a beloved symbol of the city's rich historical and mythological heritage. Today, this impressive marble head is preserved in Palazzo San Giacomo, Naples' City Hall, where it continues to inspire and connect present-day Naples with its ancient past.
- Interactive conversational interface using Gradio
- Knowledge base powered by BerkeleyDB
- Integration with Ollama for natural language processing
- Support for sharing historical facts and legends about Naples
- User-friendly chat interface with image display
- Easy-to-use reset functionality
- Example queries for better user engagement
- Python 3.10.12
- Gradio
- BerkeleyDB
- Ollama
- Clone the repository:
git clone https://github.com/RaffaeleMann/Marianna_head.git
cd Marianna_head- Install the required dependencies:
pip install gradio berkeleydb ollama- Set up the database paths in the code:
- Update the database paths in
Marianna_headclass initialization to match your system configuration - Ensure the image path for Marianna's portrait is correctly set
- Start the chatbot:
Marianna_chat.py-
Access the web interface through your browser at
http://localhost:7860 -
Interact with Marianna by:
- Responding to her welcome message with 'sì', 'no', or 'non so, scegli te'
- Asking questions about Naples' history and culture
- Using the example queries provided in the interface
Contributions are welcome! Feel free to:
- Add new historical facts and legends to the databases
- Improve the conversation flow
- Enhance the user interface
- Fix bugs and improve code quality
Please submit pull requests for any improvements you'd like to contribute.
This project is licensed under the MIT License. For details, see the LICENSE file.
- The city of Naples for preserving this important cultural artifact
- all the organizers of the project Case Tecnologie Emergenti - Infiniti Mondi Napoli Innovation City
- All contributors who help maintain and improve this project