# 🚀 LiveRAG Challenge Operational Instructions  
---
## 👣 LiveRAG Challenge Step-by-Step Guide

1. Accessing DataMorgana and Falcon3-10B-Instruct via AI71-Platform\
  1.1 Register to [AI71-Platform](https://platform.ai71.ai/register) and send the email address used for registration to sigir2025-liverag-tech@tii.ae  
  1.2 After you're notified that you have clearance, login to your [AI71-Platform account](https://platform.ai71.ai)\
    1.2.1 Access the DataMorgana [Sandbox](https://platform.ai71.ai/playground) and [try it](Operational_Instructions/DM_Sandbox.md) to get your first Q&A\
    1.2.2 Create your AI71-Platform [API key](https://platform.ai71.ai/api-keys)\
  1.3 Use your AI71-Platform key for programatic access to DataMorgana bulk requests generation via its [API](Operational_Instructions/DM_API_usage_example.ipynb)\
  1.4 Use your AI71-Platform key for programatic access to Falcon3-10B-Instruct (see [AI71 documentation](https://platform.ai71.ai/documentation))\
  **Remark:** Accessing Falcon via the AI71-Platform API is optional and recommended for a quick start. However, for a robust solution, suitable for the live event, it is recommended to set up your own Falcon3-10B-Instruct instance

3. Using [Pinecone](https://www.pinecone.io/) and [OpenSearch](https://opensearch.org/) pre-built indices of [FineWeb Sample-10BT](https://huggingface.co/datasets/HuggingFaceFW/fineweb/viewer/sample-10BT) and building your own indices\
  2.1 To use the pre-built indices follow this [sample notebook](Operational_Instructions/Indices_Usage_Examples_for_LiveRAG.ipynb)\
  2.2 To build your own **OpenSearch** index, create or use your existing AWS account and apply the provided AWS credits to save costs (see [here](Operational_Instructions/AWS_and_Pinecone_Accounts_for_LiveRAG.md))\
  2.3 To build your own **Pinecone** index, create or use your existing Pinecone account and apply the provided Pinecone credits to save costs (see [here](Operational_Instructions/Pinecone_for_LiveRAG.md)) 

4. Building, training, and evaluating your RAG system\
  3.1 Use your AWS private account or any other platform to build your RAG system using Falcon3-10B-Instruct\
  3.2 Build your own indices or use the pre-built Pinecone and OpenSearch indices\
  3.3 Use the DataMorgana [API](Operational_Instructions/DM_API_usage_example.ipynb) to get training Q&A pairs\
  3.4 Follow the [evaluation guidelines](Operational_Instructions/Evaluation_Guidelines_for_LiveRAG.md) to evaluate your RAG system 

5. You may contact the organizers via:\
  4.1 sigir2025-liverag-gen@tii.ae - for general issues\
  4.2 sigir2025-liverag-tech@tii.ae - for technical issues 

6. LiveRAG live event details will be added soon... 

---
## 📊 DataMorgana

- 📌 [**DataMorgana Overview**](Operational_Instructions/DM_Overview.md)
- 📄 [**DataMorgana ArXiv Paper**](Operational_Instructions/Generating_Diverse_Q&A_Benchmarks_for_RAG_Evaluation_with_DataMorgana.pdf)  
- 🏖️ [**DataMorgana Sandbox**](Operational_Instructions/DM_Sandbox.md)
- 🛠️ [**DataMorgana API**](Operational_Instructions/DM_API_usage_example.ipynb)  
- 🤖 [**DataMorgana Q&A Examples**](https://docs.google.com/spreadsheets/d/1rWzRiFVRWHUruP5vK4P6PNxgZgpi9OLX5YRi5Kc7k4g/edit?usp=sharing)

---
## AWS and Pinecone Documentation

- 🚀 [**AWS Documentation**](Operational_Instructions/AWS_Documentation_Links.md)
- 📂 [**Pinecone Documentation**](Operational_Instructions/Pinecone_Documentation_Links.md)

---
## 🔑 Accounts

- ☁️ [**AWS and Pinecone Accounts**](Operational_Instructions/AWS_and_Pinecone_Accounts_for_LiveRAG.md)

---

## 📚 Indices

- 🗂️ [**Using Pinecone**](Operational_Instructions/Pinecone_for_LiveRAG.md)
- 📖 [**Indices Usage Examples**](Operational_Instructions/Indices_Usage_Examples_for_LiveRAG.ipynb)

---

## 🎯 Evaluation

- 🔍 [**RAG Evaluation Guidelines**](Operational_Instructions/Evaluation_Guidelines_for_LiveRAG.md)