Execution Methods

This project provides two ways to set up and run the environment:

1. Using Docker Compose (Recommended) - Fully automated setup

2. Manual Setup (Python + Conda) - Custom setup

Each method has its advantages depending on your requirements.

---

Using Docker Compose (Recommended)

Why choose this?

✅ No need to install Python or Conda manually ✅ Automatically sets up Grobid and all dependencies ✅ Ensures a fully containerized and reproducible environment

### Steps to use Docker Compose 1. Install Docker (if not installed) from Docker official website 2. Open Docker Desktop and ensure it is running 3. Navigate to the project folder and run:

docker-compose up --build

This command: - Builds the Docker image - Sets up the environment automatically - Runs Grobid and executes the pipeline

4. Run the pre-built image (after the first build):

   docker-compose up -d
   

   This keeps the container running in the background.

5. Stop and clean up when finished:

   docker-compose down
   

---

Using Python and Conda (Manual Setup)

Why choose this?

✅ Useful for debugging and custom configurations ✅ Allows you to modify dependencies easily ✅ No need to build Docker images

### Steps for Manual Setup 1. Install Docker and pull the Grobid image

docker pull grobid/grobid:0.8.1

2. Start Grobid manually

   docker run --rm --init -p 8070:8070 -p 8071:8071 grobid/grobid:0.8.1
   

3. Install Anaconda and create the environment

   conda env create -f environment.yml
   conda activate mi_entorno
   

4. Run the project manually

   python main.py
   

---

Summary: Which Method Should You Use?

Comparison of Execution Methods

Method	Pros	Cons
Docker Compose (Recommended)	✅ Fully automated ✅ No need to install Python/Conda ✅ Ensures reproducibility	❌ Requires Docker installed
Manual Setup (Python + Conda)	✅ More flexibility ✅ Easier to debug dependencies	❌ Requires manual installation ❌ Takes longer to set up

### Recommendation - If you just want to run the project quickly, use Docker Compose. - If you need more control or want to debug the code, use the manual setup.

---