pandas-ai

# PandasAI PandasAI هي مكتبة بايثون تسهّل طرح الأسئلة على بياناتك باللغة الطبيعية. تساعد المستخدمين غير التقنيين على التفاعل مع بياناتهم بطريقة أكثر طبيعية، وتساعد المستخدمين التقنيين على توفير الوقت والجهد عند العمل مع البيانات. ## البدء التوثيق الكامل متاح على [docs.pandas-ai.com](https://docs.pandas-ai.com/). ### متطلبات بايثون إصدار بايثون `3.8+ <=3.11` ### التثبيت التثبيت باستخدام pip: ```bash pip install pandasai pip install pandasai-litellm ``` أو باستخدام poetry: ```bash poetry add pandasai poetry add pandasai-litellm ``` ### الاستخدام #### طرح الأسئلة ```python import pandasai as pai from pandasai_litellm.litellm import LiteLLM # Initialize LiteLLM with your OpenAI model llm = LiteLLM(model="gpt-4.1-mini", api_key="YOUR_OPENAI_API_KEY") # Configure PandasAI to use this LLM pai.config.set({ "llm": llm }) # Load your data df = pai.read_csv("data/companies.csv") response = df.chat("What is the average revenue by region?") print(response) ``` يمكنك طرح أسئلة أكثر تعقيداً: ```python df.chat( "What is the total sales for the top 3 countries by sales?" ) ``` المخرجات: `The total sales for the top 3 countries by sales is 16500.` #### تصوّر الرسوم البيانية يمكن لـ PandasAI إنشاء رسوم بيانية: ```python df.chat( "Plot the histogram of countries showing for each one the gdp. Use different colors for each bar", ) ``` #### عدة DataFrames مرّر عدة dataframes واطرح أسئلة تربط بينها: ```python import pandasai as pai from pandasai_litellm.litellm import LiteLLM llm = LiteLLM(model="gpt-4.1-mini", api_key="YOUR_OPENAI_API_KEY") pai.config.set({"llm": llm}) employees_data = { 'EmployeeID': [1, 2, 3, 4, 5], 'Name': ['John', 'Emma', 'Liam', 'Olivia', 'William'], 'Department': ['HR', 'Sales', 'IT', 'Marketing', 'Finance'] } salaries_data = { 'EmployeeID': [1, 2, 3, 4, 5], 'Salary': [5000, 6000, 4500, 7000, 5500] } employees_df = pai.DataFrame(employees_data) salaries_df = pai.DataFrame(salaries_data) pai.chat("Who gets paid the most?", employees_df, salaries_df) ``` المخرجات: `Olivia gets paid the most.` #### بيئة Docker المعزولة شغّل PandasAI داخل بيئة Docker معزولة لتنفيذ آمن ومعزول للكود: ```bash pip install "pandasai-docker" ``` ```python import pandasai as pai from pandasai_docker import DockerSandbox from pandasai_litellm.litellm import LiteLLM llm = LiteLLM(model="gpt-4.1-mini", api_key="YOUR_OPENAI_API_KEY") pai.config.set({"llm": llm}) sandbox = DockerSandbox() sandbox.start() # ... create dataframes ... pai.chat("Who gets paid the most?", employees_df, salaries_df, sandbox=sandbox) sandbox.stop() ``` توجد أمثلة إضافية في دليل [examples](examples). ## الترخيص PandasAI متاحة بموجب ترخيص MIT expat، باستثناء دليل `pandasai/ee` الذي له ترخيصه الخاص. يتوفر PandasAI Cloud المُدار أو العرض المؤسسي المستضاف ذاتياً عند الطلب. ## المصادر - [Docs](https://docs.pandas-ai.com/) - [Examples](examples) - [Discord](https://discord.gg/KYKj9F2FRH) ## المساهمة المساهمات مرحّب بها! اطّلع على المشكلات المفتوحة ولا تتردد في فتح طلب سحب. راجع [إرشادات المساهمة](CONTRIBUTING.md).