READMEmain

SmartSocial Manager

SmartSocial Manager is a social media management application powered by LLMs (Large Language Models) and Facebook Graph API. It provides features like sentiment analysis, content creation, post scheduling, and automated comment replies.

Features

Dashboard: View recent posts, comments, and sentiment analysis.
Sentiment Analysis: Analyze the sentiment of comments (positive, negative, neutral).
Content Creation: Generate content suggestions using LLMs.
Post Scheduling: Schedule posts for future publication.
Automated Replies: Generate and send professional replies to comments.
Profile Management: Configure page profiles, target audience, and response templates.

Project Structure

├── app/
│   ├── __init__.py         # Application factory
│   ├── config.py           # Configuration using Pydantic
│   ├── models.py           # Database models
│   ├── services/           # Service layer for business logic
│   │   ├── __init__.py
│   │   ├── facebook_service.py  # Facebook Graph API integration
│   │   ├── llm_service.py       # LLM integration (Groq)
│   │   ├── auth_service.py      # Authentication logic
│   │   ├── dashboard_service.py # Dashboard logic
│   │   └── scheduling_service.py # Post scheduling logic
│   ├── blueprints/         # Flask blueprints for routes
│   │   ├── __init__.py
│   │   ├── auth.py             # Authentication routes
│   │   ├── dashboard.py        # Dashboard routes
│   │   ├── content.py          # Content creation routes
│   │   ├── comments.py         # Comment management routes
│   │   └── settings.py         # Profile settings routes
│   ├── templates/          # HTML templates
│   │   ├── base.html           # Base layout
│   │   ├── auth/               # Login and register templates
│   │   ├── dashboard/          # Dashboard templates
│   │   ├── content/            # Content creation templates
│   │   ├── comments/           # Comment management templates
│   │   └── settings/           # Profile settings templates
│   ├── static/             # Static files (CSS, JS)
│   │   └── css/
│   │       └── style.css       # Custom styles
├── tests/                  # Unit tests (not implemented)
├── .env                    # Environment variables
├── requirements.txt        # Python dependencies
├── run.py                  # CLI for running the application
└── README.md               # Project documentation

Installation

Prerequisites

Python 3.9 or higher
MongoDB installed and running locally
Facebook Page Access Token with required permissions
Groq API Key

Steps

Clone the repository:

git clone https://github.com/your-repo/smartsocial.git
cd smartsocial

Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:
```
pip install -r requirements.txt
```

Set up the .env file:

FACEBOOK_PAGE_ACCESS_TOKEN=your_facebook_page_access_token
FACEBOOK_PAGE_ID=your_facebook_page_id
GROQ_API_KEY=your_groq_api_key
MONGODB_URI=mongodb://localhost:27017/smartsocial
SECRET_KEY=your_secret_key

Initialize the database:
```
python run.py init-db
```
Create an admin user:
```
python run.py create-admin
```
Run the application:
```
python run.py run
```

Usage

CLI Commands

Run the application:
```
python run.py run
```
Initialize the database:
```
python run.py init-db
```
Create an admin user:
```
python run.py create-admin
```
Perform a health check:
```
python run.py health-check
```

Features in Detail

Dashboard

View recent posts and comments.
Analyze sentiment of comments (positive, negative, neutral).
View engagement metrics like total comments and average comments per post.

Content Creation

Create new posts and schedule them for future publication.
Generate content suggestions using LLMs.

Comment Management

Monitor comments on posts.
Automatically reply to comments using AI-generated responses.
Filter and view negative comments.

Profile Settings

Configure page profile details like name, category, and target audience.
Manage response templates for automated replies.

Technologies Used

Backend: Flask
Database: MongoDB
LLM Integration: Groq (via langchain_groq)
Frontend: Bootstrap 5
APIs: Facebook Graph API

Development

Running Tests

(Tests are not implemented yet. Add unit tests in the tests/ directory.)

Logging

Logs are stored in the logs/ directory. You can view logs for debugging:

tail -f logs/smartsocial.log

Contributing

Fork the repository.
Create a new branch:
```
git checkout -b feature-name
```
Commit your changes:
```
git commit -m "Add feature-name"
```
Push to the branch:
```
git push origin feature-name
```
Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For questions or support, please contact:

Email: sejjari.soufiane@gmail.com
GitHub: https://github.com/soufianesejjari/smartsocial

smartSocial