About INSTAGENDA

Instagenda is a project developed by students from HE-Arc engineering school in Switzerland. The goal of this project is to create a web application that allows users to schedule Instagram posts, including media and text. The posts are automatically published when the scheduled time is reached, with team management via the Meta Graph API.

Launch the project locally

Prerequisites

• Python 3.13.1 or higher
  • https://www.python.org/doc/
• Node.js 18.0 or higher
  • https://nodejs.org/fr
• Tested with postgresql 17.4 or higher
  • https://www.postgresql.org/
• Docker 4.22.0 or higher
  • https://www.docker.com/get-started/

How to start

If you are on Windows see the How to start for Windows below

1. Clone the Repository

   git clone git@github.com:HE-Arc/Instagenda.git

2. Set Up Environment Variables
   Copy .env.exemple to .env and update the configuration as needed.

   cd ./api/instagenda
   cp .env.exemple .env
   
   cd ../../frontend
   cp .env.exemple .env

3. Start Backend Services

   cd ./api
   docker compose up -d
   docker run --name redis-server -d -p 6379:6379 redis

4. Install Python Dependencies

   pip install pipenv
   pipenv install

5. Activate the Virtual Environment

   pipenv shell

6. Run migrations and run the Backend Server

   cd ./api
   python manage.py migrate
   python manage.py runserver

7. Run the celery tool for planified tasks

   celery -A instagenda worker --loglevel=debug

8. Set Up and Start the Frontend

    cd ./frontend
    npm i
    npm run dev

How to start - With Windows

Celery tool is not working well in Windows, so you can follow the previous steps and run the 7 step in WSL.

Or you can follow those steps and create the containers.

1. Clone the Repository

   git clone git@github.com:HE-Arc/Instagenda.git

2. Set Up Environment Variables
   Copy .env.exemple to .env and update the configuration as needed.

   cd ./api/instagenda
   cp .env.exemple .env
   
   cd ../../frontend
   cp .env.exemple .env

   In each services path you need to change "localhost" by the name of the docker service.

   For example the DB_HOSTNAME is now "db" and not "localhost".

3. Install Python Dependencies

   cd ./api
   pip install pipenv
   pipenv install

4. Start Docker Services

   cd ..
   docker compose up --build

5. Set Up and Start the Frontend

    cd ./frontend
    npm i
    npm run dev

Callback URL in Meta Dashboard

In your Meta dashboard you need to configure a callback URI after the oauth call.

You need to specify this frontend URI: https://your_domain/ig-connection

Certificate

For Meta’s API to retrieve the images to be posted, they must be publicly available on the internet (i.e., hosted on a deployed website), and the HTTPS certificate must be free of major errors (such as “Chain issues: Incomplete” for example).