# 🚀 LiveRAG Challenge Operational Instructions  


## 👣 LiveRAG Challenge Onboarding


  
1. Setting up your AWS accounts\
  1.1 Accessing the AWS LiveRAG account - follow the instructions you received by email\
  1.2 Applying your AWS credits to your team account - follow the instructions you received by email\
 **Remark:** Additional details are provided in [AWS Accounts instructions](Operational_Instructions/AWS_Accounts_for_LiveRAG.md)

2. Setting your Pinecone account if you want to build your own dense index\
  2.1 Sign up for a [Pinecone](https://pinecone.io ) account, adding a payment method (upgrade to standard). You will not be charged at this time\
  2.2 Send mail sigir2025-liverag-tech@tii.ae with your team information and Pinecone account name and we will apply the $750 credits to your account\
 **Remark:** Do you use Pinecone servcies until you see the allocated credits appear in your account, otherwise you will be charged


3. Register to AI71-Platform to access DataMorgana and Falcon3-10B-Instruct LLM\
  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 are approved, login to your [AI71-Platform account](https://platform.ai71.ai)

   
---
## 👣 LiveRAG Challenge Step-by-Step Guide

1. Accessing or building your RAG indices\
  You can use the pre-built indices, [Pinecone](https://www.pinecone.io/) and [OpenSearch](https://opensearch.org/) or build your own indices on top of the same of [FineWeb Sample-10BT](https://huggingface.co/datasets/HuggingFaceFW/fineweb/viewer/sample-10BT) corpus\
  1.1 To use the pre-built indices follow this [sample notebook](Operational_Instructions/Indices_Usage_Examples_for_LiveRAG.ipynb)\
  1.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_Accounts_for_LiveRAG.md))\
  1.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)) 

2. Accessing DataMorgana and Falcon3-10B-Instruct via AI71-Platform\
  2.1 Login to your [AI71-Platform account](https://platform.ai71.ai) after you followed the onboarding instructions\
  2.2 Access the DataMorgana [Sandbox](https://platform.ai71.ai/playground) and [try it](Operational_Instructions/DM_Sandbox.md) to get your first Q&A\
  2.3 Create your AI71-Platform [API key](https://platform.ai71.ai/api-keys) \
    2.3.1 Use your AI71-Platform key for programatic access to DataMorgana bulk requests generation via its [API](Operational_Instructions/DM_API_usage_example.ipynb)\
    2.3.2 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.Building, training, and evaluating your RAG system\
  3.1 Build your RAG system in your AWS Team account leveraging your FineWeb indices - make sure to use Falcon3-10B-Instruct to generate answers\
  3.2 Train your RAG system using synthetic Q&A pairs generated by DataMorgana [API](Operational_Instructions/DM_API_usage_example.ipynb)\
  3.3 Evaluate your RAG system using the [evaluation guidelines](Operational_Instructions/Evaluation_Guidelines_for_LiveRAG.md)\

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

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

---
## 📊 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)