sanice 1.0.0__tar.gz

sanice-1.0.0/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

sanice-1.0.0/PKG-INFO

@@ -0,0 +1,458 @@
+Metadata-Version: 2.4
+Name: sanice
+Version: 1.0.0
+Summary: Biblioteca fluente para Data Science ágil (ETL, AutoML e Plotting).
+Home-page: https://github.com/wSanice/sanice
+Author: wSanice
+Author-email: wansanice@proton.me
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: matplotlib>=3.7.0
+Requires-Dist: seaborn>=0.12.0
+Requires-Dist: scikit-learn>=1.2.0
+Requires-Dist: joblib>=1.2.0
+Requires-Dist: openpyxl>=3.1.0
+Requires-Dist: pyarrow>=11.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Provides-Extra: api
+Requires-Dist: fastapi>=0.95.0; extra == "api"
+Requires-Dist: uvicorn>=0.22.0; extra == "api"
+Requires-Dist: pydantic>=1.10.0; extra == "api"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+<div align="center">
+
+# sanice
+> **S.A.N.I.C.E.**<br>
+(Sistema Automatizado de Normalização, Inteligência Computacional e Estatística)<br>
+> (System for Automated Normalization, Intelligence, Computation, and Statistics)
+
+
+
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-Apache%202.0-blue)
+![Status](https://img.shields.io/badge/status-stable-brightgreen)
+
+[🇺🇸 English](#-english) | [🇧🇷 Português](#-português) | [🇨🇳 &nbsp; 🇮🇳 &nbsp;Multi-language](#-Multilanguage)
+
+</div>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/wSanice/sanice/refs/heads/main/assets/sanice.png" alt="Sanice Banner" width="100%"/>
+</p>
+
+---
+
+<a name="-english"></a>
+## 🇺🇸 English
+
+**Sanice** is a fluent Python wrapper designed to accelerate Data Science workflows. It abstracts the complexity of Pandas, Scikit-Learn, and FastAPI into a method-chaining interface, allowing you to focus on business logic rather than syntax.
+
+### Installation
+
+```bash
+pip install sanice
+```
+
+### Quick Start
+
+**How to turn a dirty CSV into a deployed AI model in minutes.**
+
+```python
+from sanice import Sanice
+
+(Sanice("raw_data.csv")
+    .fix_columns()                    # Standardize names to snake_case
+    .transform("price", "money")      # Cleans money format ("$ 1,000.00" -> 1000.0)
+    .drop_nulls()                     # Removes empty rows
+    .create_column("total", "price * qty")
+    .handle_outliers("total")         # Removes statistical anomalies (IQR)
+    .auto_ml(                         # Trains Random Forest & saves model
+        target="sold", 
+        type="classification", 
+        save_path="my_model.pkl"
+    )
+    .serve_api()                      # Deploys a REST API on localhost:8000
+)
+```
+
+### Snippets & Command Reference
+
+Here is the complete list of available methods organized by category.
+
+#### 1. Cleaning & ETL
+| Command | Description |
+| :--- | :--- |
+| `app.fix_columns()` | Converts all column names to `snake_case`. |
+| `app.transform(col, rule)` | Applies logic: `'money'`, `'digits'`, `'email'`, `'upper'`, `'lower'`. |
+| `app.drop_nulls(strategy, val)` | Strategy: `'drop'` or `'fill'`. |
+| `app.clean_text([cols])` | Strips spaces and converts text to Title Case. |
+| `app.convert_date(col, fmt)` | Converts a string column to datetime objects. |
+
+> **Use Cases:**
+> * Standardization of data extracted from legacy systems or unformatted Excel sheets.
+> * Rapid conversion of currency strings to float before calculations.
+> * Preparation of web form data where users input dates in various formats.
+
+**Application Example:**
+```python
+# Cleaning a messy HR dataset
+(Sanice("raw_employees.csv")
+    .fix_columns()                    # "Emp Name" -> "emp_name"
+    .clean_text(["emp_name", "dept"])
+    .transform("salary", "money")     # "$ 2,500.00" -> 2500.0
+    .convert_date("hire_date")        # String -> Datetime
+)
+```
+
+#### 2. Data Manipulation
+| Command | Description |
+| :--- | :--- |
+| `app.create_column(name, logic)` | Creates a column using a string expression or lambda. |
+| `app.filter(query)` | Filters rows using SQL-like syntax (e.g., `"age > 18"`). |
+| `app.sort(col, ascending)` | Sorts the dataset by a specific column. |
+| `app.join(other_df, keys, how)` | Merges two datasets (Left, Right, Inner, Outer). |
+| `app.group([cols], val, op)` | Groups data and calculates sum, mean, or count. |
+| `app.pivot_table(idx, col, val)` | Creates a Pivot Table from the data. |
+
+> **Use Cases:**
+> * Feature Engineering (e.g., creating "average ticket" or "days since last purchase").
+> * Merging "Sales" and "Customers" tables to enrich the dataset (VLOOKUP/JOIN).
+> * Customer segmentation for specific marketing campaigns.
+
+**Application Example:**
+```python
+# Total Sales Analysis by Region
+(Sanice("sales.csv")
+    .filter("status == 'Completed'")
+    .create_column("revenue", "price * quantity")
+    .group(
+        cols=["region", "category"], 
+        value_col="revenue", 
+        operation="sum"
+    )
+    .sort("revenue", ascending=False)
+)
+```
+
+#### 3. Analytics & Visualization
+| Command | Description |
+| :--- | :--- |
+| `app.describe()` | Displays mean, std, min, max, and percentiles. |
+| `app.correlation_matrix()` | Plots a heatmap of correlations between numeric vars. |
+| `app.handle_outliers([cols])` | Removes outliers automatically using the IQR method. |
+| `app.plot(type, x, y, hue)` | Plots charts: `'bar'`, `'line'`, `'scatter'`, `'hist'`, `'box'`. |
+
+> **Use Cases:**
+> * Exploratory Data Analysis (EDA) to understand data profiles before modeling.
+> * Visual identification of variables that influence the target result (correlation).
+> * Detection and removal of anomalies (e.g., negative ages or exorbitant prices).
+
+**Application Example:**
+```python
+# Rapid Dataset Diagnosis
+(Sanice("biological_data.csv")
+    .describe()
+    .handle_outliers(["age", "glucose"]) # Remove anomalies
+    .correlation_matrix()                # Shows influence factors
+    .plot("scatter", x="age", y="glucose", hue="diagnosis")
+)
+```
+
+#### 4. AI & Machine Learning
+| Command | Description |
+| :--- | :--- |
+| `app.scale(method)` | Normalizes data using `'minmax'` or `'standard'` scaler. |
+| `app.auto_ml(target, type, path)` | AutoML pipeline: encodes, splits, trains, and saves model. |
+| `app.load_ai(path)` | Loads a pre-trained `.pkl` model into memory. |
+| `app.predict(output_col)` | Generates predictions using the loaded model. |
+
+> **Use Cases:**
+> * Quick creation of baselines to validate business hypotheses.
+> * Churn Prediction (customers likely to cancel) or Credit Scoring.
+> * Demand forecasting based on sales history (Regression).
+
+**Application Example:**
+```python
+# Training and using a Churn prediction model
+(Sanice("telecom_churn.csv")
+    .scale("minmax")
+    .auto_ml(target="churn", type="classification", save_path="my_ai.pkl")
+)
+
+# ... In another script, loading and predicting:
+(Sanice("new_customers.csv")
+    .load_ai("my_ai.pkl")
+    .predict(output_col="churn_prob")
+)
+```
+
+#### 5. Export & Deployment
+| Command | Description |
+| :--- | :--- |
+| `app.save(path)` | Exports data to `.csv`, `.xlsx`, or `.parquet`. |
+| `app.export_sql(url, table)` | Pushes the dataframe to a SQL database. |
+| `app.serve_api()` | Starts a FastAPI server to serve predictions. |
+
+> **Use Cases:**
+> * Exporting treated data (Bronze -> Silver) to BI tools like Power BI or Tableau.
+> * Instant creation of AI microservices for Mobile or Web App integration.
+> * Persistence of clean data into relational databases (PostgreSQL/MySQL).
+
+**Application Example:**
+```python
+# Final Pipeline: Clean -> Save Parquet -> Deploy API
+(Sanice("raw_data.csv")
+    .fix_columns()
+    .auto_ml("target", "regression", "model.pkl")
+    .save("clean_data.parquet")   # Data Backup
+    .serve_api()                  # API Online at http://localhost:8000
+)
+```
+
+### License
+
+This project is licensed under the Apache License, Version 2.0. See the [LICENSE](https://www.apache.org/licenses/LICENSE-2.0)  for details.
+
+<br>
+
+---
+
+<a name="-português"></a>
+## 🇧🇷 Português
+
+**Sanice** é um wrapper Python fluido projetado para acelerar fluxos de trabalho de Data Science. Ele abstrai a complexidade do Pandas, Scikit-Learn e FastAPI em uma interface de encadeamento de métodos (method-chaining), permitindo que você foque na lógica de negócios em vez da sintaxe.
+
+### Instalação
+
+```bash
+pip install sanice
+```
+
+### Início Rápido
+
+**Como transformar um CSV sujo em um modelo de IA em produção em minutos.**
+
+```python
+from sanice import Sanice
+
+(Sanice("raw_data.csv")
+    .corrigir_colunas()               # Padroniza nomes para snake_case
+    .transformar("price", "dinheiro") # Limpa formato monetário ("R$ 1.000,00" -> 1000.0)
+    .remover_nulos()                  # Remove linhas vazias
+    .criar_coluna("total", "price * qty")
+    .tratar_outliers("total")         # Remove anomalias estatísticas (IQR)
+    .auto_ml(                         # Treina Random Forest & salva modelo
+        alvo="sold", 
+        tipo="classificacao", 
+        salvar_modelo="my_model.pkl"
+    )
+    .servir_api()                     # Sobe uma API REST em localhost:8000
+)
+```
+
+### Snippets e Referência de Comandos
+
+Aqui está a lista completa de métodos disponíveis organizados por categoria.
+
+#### 1. Limpeza e ETL
+| Comando | Descrição |
+| :--- | :--- |
+| `app.corrigir_colunas()` | Converte todos os nomes de colunas para `snake_case`. |
+| `app.transformar(col, rule)` | Aplica lógica: `'dinheiro'`, `'numeros'`, `'email'`, `'upper'`, `'lower'`. |
+| `app.remover_nulos(strategy, val)` | Estratégia: `'apagar'` (drop) ou `'preencher'` (fill). |
+| `app.limpar_texto([cols])` | Remove espaços extras e converte texto para Title Case. |
+| `app.converter_data(col, fmt)` | Converte uma coluna de string para objetos datetime. |
+
+> **Casos de Uso:**
+> * Padronização de dados extraídos de sistemas legados ou planilhas Excel desformatadas.
+> * Conversão rápida de colunas de moeda brasileira (R$) para float antes de cálculos.
+> * Preparação de dados de formulários web onde usuários inserem datas em formatos variados.
+
+**Exemplo de Aplicação:**
+```python
+# Limpeza de uma base de RH desorganizada
+(Sanice("funcionarios_bruto.csv")
+    .corrigir_colunas()                 # "Nome Func" -> "nome_func"
+    .limpar_texto(["nome_func", "setor"])
+    .transformar("salario", "dinheiro") # "R$ 2.500,00" -> 2500.0
+    .converter_data("data_admissao")    # String -> Datetime
+)
+```
+
+#### 2. Manipulação de Dados
+| Comando | Descrição |
+| :--- | :--- |
+| `app.criar_coluna(name, logic)` | Cria uma coluna usando expressão string ou lambda. |
+| `app.filtrar(query)` | Filtra linhas usando sintaxe estilo SQL (ex: `"age > 18"`). |
+| `app.ordenar(col, ascending)` | Ordena o dataset por uma coluna específica. |
+| `app.unir(other_df, keys, how)` | Une dois datasets (Left, Right, Inner, Outer). |
+| `app.agrupar([cols], val, op)` | Agrupa dados e calcula soma, média ou contagem. |
+| `app.tabela_dinamica(idx, col, val)` | Cria uma Tabela Dinâmica a partir dos dados. |
+
+> **Casos de Uso:**
+> * Criação de Features (Feature Engineering) como "ticket médio" ou "dias desde a última compra".
+> * Unificação de tabelas de "Vendas" e "Clientes" para enriquecer o dataset (VLOOKUP/JOIN).
+> * Segmentação de base de clientes para campanhas de marketing específicas.
+
+**Exemplo de Aplicação:**
+```python
+# Análise de Vendas Totais por Região
+(Sanice("vendas.csv")
+    .filtrar("status == 'Concluido'")
+    .criar_coluna("faturamento", "preco * quantidade")
+    .agrupar(
+        cols=["regiao", "categoria"], 
+        value_col="faturamento", 
+        operacao="soma"
+    )
+    .ordenar("faturamento", ascendente=False)
+)
+```
+
+#### 3. Análise e Visualização
+| Comando | Descrição |
+| :--- | :--- |
+| `app.resumo_estatistico()` | Exibe média, desvio padrão, min, max e percentis. |
+| `app.matriz_correlacao()` | Plota um mapa de calor das correlações entre vars numéricas. |
+| `app.tratar_outliers([cols])` | Remove outliers automaticamente usando o método IQR. |
+| `app.plotar(type, x, y, hue)` | Plota gráficos: `'bar'`, `'line'`, `'scatter'`, `'hist'`, `'box'`. |
+
+> **Casos de Uso:**
+> * Análise Exploratória de Dados (EDA) para entender o perfil dos dados antes da modelagem.
+> * Identificação visual de variáveis que influenciam o resultado desejado (correlação).
+> * Detecção e remoção de anomalias (ex: idades negativas ou preços exorbitantes).
+
+**Exemplo de Aplicação:**
+```python
+# Diagnóstico rápido de dataset
+(Sanice("dados_biologicos.csv")
+    .resumo_estatistico()
+    .tratar_outliers(["idade", "glicose"]) # Remove anomalias
+    .matriz_correlacao()                   # Mostra o que influencia o que
+    .plotar("scatter", x="idade", y="glicose", hue="diagnostico")
+)
+```
+
+#### 4. IA e Machine Learning
+| Comando | Descrição |
+| :--- | :--- |
+| `app.escalonar(method)` | Normaliza dados usando escalonador `'minmax'` ou `'standard'`. |
+| `app.auto_ml(target, type, path)` | Pipeline AutoML: encode, split, treino e salvamento do modelo. |
+| `app.carregar_ia(path)` | Carrega um modelo `.pkl` pré-treinado na memória. |
+| `app.prever(output_col)` | Gera previsões usando o modelo carregado. |
+
+> **Casos de Uso:**
+> * Criação rápida de *baselines* (modelos de referência) para validar hipóteses.
+> * Previsão de Churn (clientes que vão cancelar) ou Score de Crédito.
+> * Previsão de demanda de estoque baseada em histórico de vendas.
+
+**Exemplo de Aplicação:**
+```python
+# Treinando e usando um modelo de previsão de Churn
+(Sanice("telecom_churn.csv")
+    .escalonar("minmax")
+    .auto_ml(alvo="churn", tipo="classificacao", salvar_modelo="meu_ia.pkl")
+)
+
+# ... Em outro script, carregando e prevendo:
+(Sanice("novos_clientes.csv")
+    .carregar_ia("meu_ia.pkl")
+    .prever(output_col="probabilidade_churn")
+)
+```
+
+#### 5. Exportação e Deploy
+| Comando | Descrição |
+| :--- | :--- |
+| `app.salvar(path)` | Exporta dados para `.csv`, `.xlsx` ou `.parquet`. |
+| `app.exportar_sql(url, table)` | Envia o dataframe para um banco de dados SQL. |
+| `app.servir_api()` | Inicia um servidor FastAPI para servir previsões. |
+
+> **Casos de Uso:**
+> * Exportação de dados tratados para ferramentas de BI como Power BI.
+> * Criação instantânea de microserviços de IA para integração com Apps.
+> * Persistência de dados limpos em bancos relacionais (PostgreSQL/MySQL).
+
+**Exemplo de Aplicação:**
+```python
+# Pipeline final: Limpa -> Salva Parquet -> Vira API
+(Sanice("dados_brutos.csv")
+    .corrigir_colunas()
+    .auto_ml("target", "regressao", "modelo.pkl")
+    .salvar("dados_limpos.parquet") # Backup dos dados
+    .servir_api()                   # API Online em http://localhost:8000
+)
+```
+
+---
+<a name="-Multilanguage"></a>
+### Multi-language Support / Suporte Multilíngue
+
+Sanice is designed for global people. You can call methods in English, Portuguese, Chinese, or Hindi. <br>
+*O Sanice foi projetado para equipes globais. Você pode chamar métodos em Inglês, Português, Chinês ou Hindi.*
+
+<details>
+<summary><b>CLICK HERE to see the full Command Translation Table / CLIQUE AQUI para ver a Tabela de Tradução</b></summary>
+<br>
+
+| 🇧🇷 PT-BR (Original) | 🇺🇸 English | 🇨🇳 Chinese (中文) | 🇮🇳 Hindi (Hinglish) |
+| :--- | :--- | :--- | :--- |
+| `corrigir_colunas` | `fix_columns` | `修正列名` | `column_sudhare` |
+| `limpar_texto` | `clean_text` | `清洗文本` | `text_safai` |
+| `remover_nulos` | `remove_nulls` | `移除空值` | `null_hataye` |
+| `converter_data` | `convert_date` | `转换日期` | `date_badlo` |
+| `criar_coluna` | `create_column` | `创建列` | `column_banaye` |
+| `filtrar` | `filter_data` | `过滤数据` | `filter_kare` |
+| `ordenar` | `sort_data` | `排序数据` | `sort_kare` |
+| `unir` | `join_data` | `合并数据` | `jode` |
+| `plotar` | `plot_chart` | `绘制图表` | `graph_banaye` |
+| `resumo_estatistico` | `stats_summary` | `统计摘要` | `stats_dekhe` |
+| `salvar` | `save_file` | `保存文件` | `save_kare` |
+| `auto_ml` | `train_automl` | `自动训练` | `automl_kare` |
+| `carregar_ia` | `load_ai` | `加载模型` | `ai_load_kare` |
+| `prever` | `predict` | `预测` | `bhavishya_bataye` |
+| `ver` | `view` | `查看` | `dekhe` |
+| `ajuda` | `help` | `帮助` | `madad` |
+| `agrupar` | `group_by` | `分组` | `samuh_banaye` |
+| `tabela_dinamica` | `pivot_table` | `透视表` | `pivot_table` |
+| `exportar_sql` | `export_sql` | `导出SQL` | `sql_export` |
+| `matriz_correlacao` | `correlation_matrix` | `相关矩阵` | `sambandh_matrix` |
+| `tratar_outliers` | `handle_outliers` | `处理异常值` | `outliers_hataye` |
+| `escalonar` | `scale_data` | `数据缩放` | `scale_kare` |
+| `servir_api` | `serve_api` | `启动API` | `api_chalu_kare` |
+| `transformar` | `transform` | `数据转换` | `badlav_kare` |
+
+</details>
+
+### Licença
+
+Este projeto está licenciado sob a Apache License, Version 2.0. Consulte a [LICENSE](https://www.apache.org/licenses/LICENSE-2.0)  para obter detalhes.
+
+<div align="right">
+    <a href="#sanice">⬆️ Back to Top</a>
+</div>
+
+---
+Desenvolvido por **wSanice**.