Apppublic

syedanaazimaunnisa/Heritage-chatbot

sourceHugging Faceupdated 1y agoView on Hugging Face

0likes

App README

syedanaazima007

Spice&Story - Community Recipe & Lore Hub 🗣️

Spice&Story is a Streamlit application built to celebrate and preserve the rich tapestry of Indian heritage — through proverbs, folk tales, historical lore, and local recipes. It empowers community members to contribute, store, and sync cultural knowledge from diverse regions across India.

Key Features

Contribution Form

Users can submit text-based contributions, specifying:

—Language
—Region
—Contributor’s name (optional)

Local Storage

All contributions are saved locally in a SQLite database (proverbs.db) for offline access and future syncing.

Simulated AI Classification

A mock AI classifier categorizes entries into:

—Proverb
—Folk Tale
—Recipe
—Historical Lore
—Uncategorized

Classification is keyword-based and for demonstration purposes.

Sync Functionality

Click the "Sync Pending Contributions" button to simulate syncing local data to a central server. Synced entries are marked with the status synced.

Interactive Dashboard

The dashboard provides:

—✅ Total contributions
—📋 Table of 10 most recent submissions
—📈 Bar charts showing counts by:
—Language
—AI-classified category

🛠 Technologies Used

—Python – Core language
—Streamlit – UI and interactivity
—SQLite3 – Local storage
—Pandas – Data manipulation and display

Getting Started

Prerequisites

—Python 3.x

Installation & Running

1.Clone or download the project folder. Ensure the following files are in the same directory:

    app.py
    requirements.txt

1.Install dependencies:

bash

    pip install -r requirements.txt

1.Run the application:

bash

    streamlit run app.py

1.The app will open in your browser automatically.

Database Schema

The SQLite database (proverbs.db) contains one table: contributions

Field	Type	Description
`id`	INTEGER (PK)	Auto-incremented primary key
`text`	TEXT	The contribution content
`language`	TEXT	Language of the contribution
`region`	TEXT	Regional origin of the content
`contributor`	TEXT	Name of the contributor
`category`	TEXT	AI-assigned category
`timestamp`	DATETIME	Submission time
`status`	TEXT	Sync status (`pending_sync` or `synced`)

📁 Project Structure

Spice&Story/

├── app.py # Main Streamlit app

├── proverbs.db # SQLite database

├── requirements.txt # Project dependencies

└── README.md # Project overview (this file)

Contributing

We welcome contributions! Feel free to fork the repository, make enhancements, and submit a pull request.

License

This project is open-source and available under the MIT License.