https://github.com/syntax-queen/adc-backend

Anonymous dream journal meets real-time chat share, comment, and explore AI-powered cultural interpretations.
https://github.com/syntax-queen/adc-backend

chat-app chat-application dream-analysis flask openai vue websocket

Last synced: about 2 months ago
JSON representation

Anonymous dream journal meets real-time chat share, comment, and explore AI-powered cultural interpretations.

• Host: GitHub
• URL: https://github.com/syntax-queen/adc-backend
• Owner: Syntax-Queen
• License: mit
• Created: 2025-09-26T19:48:40.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-10-04T19:57:06.000Z (9 months ago)
• Last Synced: 2025-10-04T21:29:16.730Z (9 months ago)
• Topics: chat-app, chat-application, dream-analysis, flask, openai, vue, websocket
• Language: Python
• Homepage:
• Size: 1.13 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ADC - Ai Dream Chat

A unique real-time platform where users can post about their dreams, share interpretations, and connect through comments  all while staying anonymous.  

No profile pictures, no flashy bios just raw conversations. Users can also choose to repost the AI’s deep cultural analysis of their dream so others can learn what it means in different traditions and societies.  

Built from scratch with a Python backend and modern frontend tools.  

## 🌍 Live Demo

[View Live Website](https://your-live-app-link.com)

---

## 📖 Documentation

- [API Docs](ADC-documentation.json)

- [WebSocket Docs](docs/websocket.md)

## 🌟 Features

- User authentication (sign up, login, JWT tokens)  

- Post dreams & add comments  

- Create chat groups, invite via unique link, add/remove users

- Share dreams and get comments from other users

- AI-powered dream interpretation that explores meanings in your own culture and across others

- Option to repost AI interpretations for the community to learn from

- Real-time messaging with WebSockets  

- Time-based edit restrictions (e.g. you can edit a post only within 3 hours)  

- Anonymous by design no profile photo or personal bios collected

-  Clean, distraction-free frontend UI  

---

## 🧰 Tech Stack

| Component        | Technology / Library      |

|------------------|---------------------------|

| Backend          | Python, Flask             |

| DB & Migrations  | SQLAlchemy, Flask-Migrate |

| Real-time        | Flask-SocketIO            |

| Authentication   | JWT, Flask-HTTPAuth        |

| Dev / Production DB | SQLite (dev), Postgres (prod) |

---

## 🚀 Installation & Setup

# bash

git clone https://github.com/Syntax-Queen/ADC-Backend.git

cd ADC-Backend

python -m venv .venv

.venv/bin/activate         # or Windows: .venv\Scripts\activate

pip install -r requirements.txt

# Setup your config (e.g. SECRET_KEY, database URI) in `config.py` or via env vars

flask db migrate -m "Initial migration"

flask db upgrade

# Run with WebSocket support

python app.py               # or flask run if you wire socketio.run in your entry

---

## 📸 Screenshots

### 🔑 Authentication

![Signup](docs/screenshots/signup.png)

![Login](docs/screenshots/login.png)

### 👥 Group Management

![Create-Group](docs/screenshots/create-group.png)

![delete-Group](docs/screenshots/delete-group.png)

![join-Group](docs/screenshots/join-group.png)

### 💬 Messaging

![group-message](docs/screenshots/message.png)

![Post](docs/screenshots/post.png)

![view-all-messages](docs/screenshots/view-all-messages.png)

![view-posts-comments](docs/screenshots/view-post-comments.png)

---

# Project Layout

├── app.py

├── auth.py

├── config.py

├── models.py

├── routes/

│   └── user.py

├── migrations/

├── requirements.txt

└── docs/

    └── screenshots/