Postopia🗂️

final.demo.postopia.mp4

Overview

Postopia is a full-stack web application designed to revolutionize your social media content creation process. Leveraging cutting-edge AI, it intelligently generates engaging posts tailored for various platforms. Beyond creation, Postopia empowers users with robust management tools to organize, update, and curate their social media content efficiently. It's your ultimate companion for consistent and impactful online presence.

🌟 Features

• 🧠 AI-Powered Content Generation: Generate unique social media posts by simply providing a topic and selecting your desired platform (Twitter, Instagram, LinkedIn, Facebook). Powered by advanced language models to ensure contextually relevant and platform-appropriate content.
• 📝 Comprehensive Post Management : Enjoy full control over your content with Create, Read, Update, and Delete functionalities for all your generated posts.
• 📋 Intuitive Post Listing: A clean and interactive list to view all your created social media posts at a glance.
• 🔍 Global Exception Handling & Logging: Robust backend infrastructure with detailed logging and global exception handling for enhanced reliability and easier debugging.

💻 Tech Stack

Frontend

• Framework: Next.js 15.x (React Framework)
• Language: TypeScript
• UI Library: Chakra UI for accessible and modular UI components
• Styling: Tailwind CSS for utility-first CSS
• State Management: Zustand for lightweight global state management
• Form Handling: React Hook Form for efficient form validation and management

Backend

• Framework: FastAPI (Python web framework for building APIs)
• Language: Python 3.10+
• Database: Supabase (PostgreSQL-as-a-Service) for robust and scalable data storage
• AI Integration: Langchain for orchestrating AI models
• Language Model: Hugging Face (deepseek-ai/DeepSeek-V3) for powerful text generation
• Dependency Management: Poetry

🏁 Getting Started

Follow these steps to set up and run Postopia on your local machine.

Prerequisites

Ensure you have the following installed:

• Node.js (v20 or later)
• Python (v3.10 or later)
• Poetry (for Python dependency management)

Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Install dependencies:

   poetry install

3. Configure Environment Variables: Create a file named .env in the backend directory and add your API keys and URLs. You will need:

   • Your Supabase project URL and Anon Key.
   • Your Hugging Face API Token (for AI model access).

   Example .env file:

   SUPABASE_URL="YOUR_SUPABASE_PROJECT_URL"
   SUPABASE_KEY="YOUR_SUPABASE_ANON_KEY"
   HF_API_KEY="YOUR_HUGGINGFACE_API_TOKEN"
   

4. Run the Backend Server:

   poetry run uvicorn app.main:app --reload

   The backend server will start on http://127.0.0.1:8000.

Frontend Setup

1. Navigate to the frontend directory:

   cd frontend 

2. Install dependencies:

   npm install

3. Run the Frontend Development Server:

   npm run dev

   The frontend development server will start on http://localhost:3000.

🧑‍💻 Usage

1. Access the Application: Once both the backend and frontend servers are running, open your web browser and navigate to http://localhost:3000.
2. Generate Posts: Use the "Generate Post" dialog to input a topic and select a platform. The AI will create content for you.
3. Save Posts: (This feature is currently under development to be fully implemented and connected to the backend. Once generated, you will be able to save posts to Supabase.)
4. View Posts: See your saved posts listed on the main page.

🤝 Contributing

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

1. Fork the repository.
2. Create your Feature Branch: git checkout -b feature/YourAmazingFeature
3. Commit your Changes: git commit -m 'Add some AmazingFeature'
4. Push to the Branch: git push origin feature/YourAmazingFeature
5. Open a Pull Request.