# 1) انسٹال کریں
# pip install llama-index llama-index-embeddings-openai llama-index-llms-openai
import os
from llama_index.core import VectorStoreIndex, SimpleDirectoryReader
from llama_index.embeddings.openai import OpenAIEmbedding
from llama_index.llms.openai import OpenAI
# 2) اپنے ماڈل + ایمبیڈنگز کو کنفیگر کریں
os.environ["OPENAI_API_KEY"] = "YOUR_KEY" # یا کسی بھی سپورٹڈ LLM/ایمبیڈنگ پرووائیڈر کو استعمال کریں
llm = OpenAI(model="gpt-4o-mini")
embed_model = OpenAIEmbedding(model="text-embedding-3-small")
# 3) دستاویزات لوڈ کریں (مثال کے طور پر، ./data/*.pdf, .md, .txt)
docs = SimpleDirectoryReader("./data").load_data
# 4) ایک انڈیکس بنائیں
index = VectorStoreIndex.from_documents(docs, embed_model=embed_model)
# 5) ایک کوئری انجن بنائیں اور ایک سوال پوچھیں
query_engine = index.as_query_engine(llm=llm)
response = query_engine.query("دستاویزات میں ذکر کردہ اہم حفاظتی طریقے کیا ہیں؟")
print(response)

from llama_index.core import SimpleDirectoryReader
from llama_index.readers.web import SimpleWebPageReader
file_docs = SimpleDirectoryReader("./policies").load_data
web_docs = SimpleWebPageReader(html_to_text=True).load_data
all_docs = file_docs + web_docs

from llama_index.core.node_parser import SentenceSplitter
from llama_index.core import Document
parser = SentenceSplitter(chunk_size=800, chunk_overlap=100)
nodes = []
for d in all_docs:
nodes.extend(parser.get_nodes_from_documents([Document(text=d.text, metadata=d.metadata)]))

from llama_index.core import VectorStoreIndex, SummaryIndex
from llama_index.core.retrievers import BM25Retriever
from llama_index.core.query_engine import RetrieverQueryEngine
# پہلے سے پارسڈ نوڈس سے ویکٹر انڈیکس
v_index = VectorStoreIndex(nodes)
# BM25 کی ورڈ ریٹریور
bm25_retriever = BM25Retriever.from_defaults(nodes=nodes, similarity_top_k=6)
# ہائبرڈ: امیدواروں کو ضم کریں، پھر ری رینک کریں
from llama_index.core.retrievers import RouterRetriever
from llama_index.retrievers.merge import MergerRetriever
v_retriever = v_index.as_retriever(similarity_top_k=6)
hybrid = MergerRetriever(retrievers=[v_retriever, bm25_retriever], top_k=8)
query_engine = RetrieverQueryEngine.from_args(retriever=hybrid)

from llama_index.postprocessor.flag_embedding_reranker import FlagEmbeddingReranker
from llama_index.core.query_engine import RetrieverQueryEngine
reranker = FlagEmbeddingReranker(top_n=5, model="BAAI/bge-reranker-base")
query_engine = v_index.as_query_engine(
similarity_top_k=12,
node_postprocessors=[reranker]
)

from llama_index.core.response_synthesizers import get_response_synthesizer
from llama_index.core import ServiceContext
synth = get_response_synthesizer(response_mode="tree_summarize")
query_engine = v_index.as_query_engine(response_synthesizer=synth)
ans = query_engine.query("آن بورڈنگ کے اقدامات کا خلاصہ کریں اور ذرائع کا حوالہ دیں۔")
print(ans)

from llama_index.core.prompts import PromptTemplate
qa_tmpl = PromptTemplate(
"""
آپ ایک مختصر، ثبوت پر مبنی معاون ہیں۔ صرف فراہم کردہ سیاق و سباق استعمال کریں۔
اگر یقین نہیں ہے تو کہیں کہ آپ کو نہیں معلوم۔ کلیدوں کے ساتھ JSON واپس کریں: جواب، ذرائع۔
سوال: {query_str}
سیاق و سباق: {context_str}
"""
)
query_engine = v_index.as_query_engine(text_qa_template=qa_tmpl)

from llama_index.core.agent import ReActAgent
from llama_index.tools.sql import SQLQueryEngineTool
from sqlalchemy import create_engine
engine = create_engine("sqlite:///analytics.db")
sql_tool = SQLQueryEngineTool.from_engine(engine)
agent = ReActAgent.from_tools([sql_tool], llm=llm, verbose=True)
agent.chat("Q2 2025 میں ماہانہ چرن کیا تھا؟ اگر ضرورت ہو تو DB سے استفسار کریں۔")

from llama_index.core.evaluation import FaithfulnessEvaluator, RelevancyEvaluator
faith = FaithfulnessEvaluator(llm=llm)
rel = RelevancyEvaluator(llm=llm)
pred = query_engine.query("ہماری پالیسی میں SOC 2 کنٹرول فیملیز کی فہرست دیں۔")
print("وفادار؟", faith.evaluate_response(pred))
print("متعلقہ؟", rel.evaluate_response(pred))

# مثال: Chroma
# pip install chromadb llama-index-vector-stores-chroma
from llama_index.vector_stores.chroma import ChromaVectorStore
from llama_index.core import StorageContext
import chromadb
chroma_client = chromadb.PersistentClient(path="./chroma_store")
collection = chroma_client.get_or_create_collection("company_knowledge")
vector_store = ChromaVectorStore(chroma_collection=collection)
storage_context = StorageContext.from_defaults(vector_store=vector_store)
index = VectorStoreIndex.from_documents(all_docs, storage_context=storage_context)

# مثال: کوئری کے وقت میٹا ڈیٹا پر مبنی فلٹرنگ
retriever = index.as_retriever(similarity_top_k=8)
retriever.metadata_filters = {"department": ["legal", "security"], "published": [True]}

# کم سے کم FastAPI ریپر
# pip install fastapi uvicorn
from fastapi import FastAPI
app = FastAPI
qe = index.as_query_engine(llm=llm)
@app.post("/query")
async def query(payload: dict):
q = payload.get("q", "")
resp = qe.query(q)
return {"answer": str(resp), "sources": [s.node.metadata for s in resp.source_nodes]}