Metadata-Version: 2.4
Name: aisolusoft-ai
Version: 0.1.1
Summary: AI-powered document analysis and business automation SDK
Author: Bhargav Dakwala
License: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pypdf>=5.0.0
Requires-Dist: openpyxl>=3.1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: ruff>=0.6.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Dynamic: license-file

# AISoluSoft AI

AI-powered document extraction and analysis SDK for Python.

`aisolusoft-ai` provides a simple and modular Python API for extracting text from documents and analyzing document content.

## Features

* PDF text extraction
* TXT document extraction
* Markdown document extraction
* Simple document analysis API
* Structured analysis results
* Modular architecture
* Python 3.11+ support
* Designed for future AI provider integrations

## Installation

Install AISoluSoft AI from PyPI:

```bash
pip install aisolusoft-ai
```

## Quick Start

### Extract and Analyze a PDF

```python
from aisolusoft_ai import DocumentExtractor, DocumentAnalyzer

PDF_FILE = r"C:\data\code\content.pdf"

# Extract document text
extractor = DocumentExtractor()

text = extractor.extract(PDF_FILE)

print("===== EXTRACTED TEXT =====")
print(text)

# Analyze extracted text
analyzer = DocumentAnalyzer()

result = analyzer.analyze_text(text)

print("===== ANALYSIS =====")
print(result.summary)
```

## How It Works

AISoluSoft AI separates document extraction from document analysis.

```text
PDF / TXT / Markdown
        |
        v
DocumentExtractor
        |
        v
Extracted Text
        |
        v
DocumentAnalyzer
        |
        v
AnalysisResult
```

This architecture keeps document processing and analysis separate, making the SDK easier to extend.

## Document Extraction

### PDF

```python
from aisolusoft_ai import DocumentExtractor

extractor = DocumentExtractor()

text = extractor.extract(
    r"C:\data\code\content.pdf"
)

print(text)
```

### TXT

```python
from aisolusoft_ai import DocumentExtractor

extractor = DocumentExtractor()

text = extractor.extract(
    r"C:\data\code\document.txt"
)

print(text)
```

### Markdown

```python
from aisolusoft_ai import DocumentExtractor

extractor = DocumentExtractor()

text = extractor.extract(
    r"C:\data\code\document.md"
)

print(text)
```

## Document Analysis

```python
from aisolusoft_ai import DocumentAnalyzer

analyzer = DocumentAnalyzer()

result = analyzer.analyze_text(
    "This is an example document."
)

print(result.summary)
```

The analysis API returns an `AnalysisResult` object.

```python
print(result.summary)
print(result.file)
```

## Combined Workflow

A complete document-processing workflow looks like this:

```python
from aisolusoft_ai import DocumentExtractor, DocumentAnalyzer

PDF_FILE = r"C:\data\code\content.pdf"

# 1. Extract document text
extractor = DocumentExtractor()

text = extractor.extract(PDF_FILE)

print("===== EXTRACTED TEXT =====")
print(text)

# 2. Analyze the extracted text
analyzer = DocumentAnalyzer()

result = analyzer.analyze_text(text)

print("===== ANALYSIS =====")
print(result.summary)
```

## Supported File Formats

| Format            | Status    |
| ----------------- | --------- |
| PDF               | Supported |
| TXT               | Supported |
| Markdown          | Supported |
| Excel             | Planned   |
| Word              | Planned   |
| Scanned PDF / OCR | Planned   |

## Architecture

The package is designed to evolve into a complete AI document-processing SDK.

```text
                    AISoluSoft AI
                          |
             +------------+------------+
             |                         |
             v                         v
     Document Extraction       Document Analysis
             |                         |
     +-------+-------+                 |
     |       |       |                 v
    PDF     TXT      MD          AI Provider
                                      |
                              +-------+-------+
                              |               |
                              v               v
                           OpenAI       Azure OpenAI
```

## Current API

### DocumentExtractor

```python
from aisolusoft_ai import DocumentExtractor

extractor = DocumentExtractor()

text = extractor.extract("document.pdf")
```

`DocumentExtractor` is responsible for reading supported document formats and returning extracted text.

### DocumentAnalyzer

```python
from aisolusoft_ai import DocumentAnalyzer

analyzer = DocumentAnalyzer()

result = analyzer.analyze_text(text)

print(result.summary)
```

`DocumentAnalyzer` provides the document analysis interface.

### AnalysisResult

The analyzer returns an `AnalysisResult` object.

```python
result.summary
result.file
```

Example:

```python
print(result.summary)
print(result.file)
```

## Version 0.1.1

This release improves the package documentation and provides the initial public document-processing API.

Current functionality includes:

* PDF extraction
* TXT extraction
* Markdown extraction
* Document analysis API
* Structured `AnalysisResult`
* Modular package architecture

## Roadmap

Future releases are planned to include:

* [ ] OpenAI integration
* [ ] Azure OpenAI integration
* [ ] AI-powered summarization
* [ ] Document classification
* [ ] Entity extraction
* [ ] Structured AI output
* [ ] Excel extraction
* [ ] Word document extraction
* [ ] OCR for scanned PDFs
* [ ] Async API
* [ ] Retry handling
* [ ] Logging
* [ ] Advanced document metadata
* [ ] Comprehensive test coverage

## Example Use Cases

AISoluSoft AI can be used as a foundation for applications such as:

* AI document assistants
* Business document analysis
* Customer support automation
* Enterprise knowledge applications
* Document processing systems
* AI-powered internal tools
* Document automation
* Software prototypes

## Requirements

* Python 3.11 or later

## Dependencies

The package uses modern Python libraries for document processing and future AI integration.

## License

This project is licensed under the MIT License.

See the `LICENSE` file for details.

## Author

**Bhargav Dakwala**

AISoluSoft

AI & Technology Architecture

## PyPI

AISoluSoft AI is available on PyPI:

https://pypi.org/project/aisolusoft-ai/

## Disclaimer

This project is under active development. APIs and functionality may change between releases.

---

Made with Python by AISoluSoft.
