Metadata-Version: 2.2
Name: inferia
Version: 0.1.2b0
Summary: Inferia is a Python module designed to streamline the creation and deployment of inference services. It provides tools and abstractions to wrap machine learning models and expose them as robust, production-ready APIs with minimal effort.
Author-email: freepik-company/tech-avengers <aivengers@freepik.com>
Project-URL: Homepage, https://github.com/freepik-company/fc-py-inferia
Project-URL: Issues, https://github.com/freepik-company/fc-py-inferia/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1.8
Requires-Dist: fastapi>=0.115.6
Requires-Dist: jinja2>=3.1.5
Requires-Dist: pydantic>=2.10.5
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: structlog>=25.1.0
Requires-Dist: uvicorn>=0.34.0

# Freepik Company inferia

Inferia is a versatile Python module aimed at simplifying the development and deployment of inference services. 
It allows users to wrap machine learning models or any computational logic into APIs effortlessly. 
With inferia, you can focus on your core algorithmic functionality while the module takes care of the heavy lifting, 
including API structure, request handling, error management, and scalability.

Key features include:
- Ease of Use: Simplifies the process of converting your models into production-ready APIs with minimal boilerplate code.
- Customizable API: Provides flexibility to define endpoints, input/output formats, and pre- / post-processing logic.
- Scalability: Optimized to handle high-throughput scenarios with support for modern server frameworks.
- Extensibility: Easily integrates with third-party libraries, monitoring tools, or cloud services.
- Error Handling: Built-in mechanisms to catch and handle runtime issues gracefully.

## Development

### Build the local development environment

```sh
make build
```

## Installation

### Using pip
Then, you can install the package:
```sh
pip install inferia
```

## Run example application

```sh
cd examples
python app.py
```

## Usage Guide: Inferia CLI

The **Inferia CLI** provides several commands to initialize, scaffold, and run your inference-based projects. This guide explains the available commands and their options.

---

## CLI Reference

- [Commands](#commands)
  - [Initialize](#initialize)
  - [Scaffold](#scaffold)
  - [Run](#run)

---


### Initialize

Command: `init`

**Description:** Initialize the project configuration with default or custom settings.

#### Options:

- `-s, --scaffold`: Generate a scaffold prediction class during initialization.
- `-d, --default`: Initialize with default values without prompts.
- `-f, --force`: Force initialization even if a configuration file already exists.

#### Usage:

```bash
inferia-cli init [OPTIONS]
```

**Examples:**

1. Initialize with prompts:
   ```bash
   inferia-cli init
   ```

2. Initialize with default values:
   ```bash
   inferia-cli init --default
   ```

3. Initialize and scaffold prediction classes:
   ```bash
   inferia-cli init --scaffold
   ```

---

### Scaffold

Command: `scaffold`

**Description:** Generate prediction class files based on the routes defined in the configuration file (`inferia.yaml`).

#### Options:

- `-f, --force`: Overwrite existing files if they already exist.

#### Usage:

```bash
inferia-cli scaffold [OPTIONS]
```

**Examples:**

1. Scaffold prediction classes:
   ```bash
   inferia-cli scaffold
   ```

2. Scaffold and overwrite existing files:
   ```bash
   inferia-cli scaffold --force
   ```

---

### Run

Command: `run`

**Description:** Run the Inferia application based on the configuration in the specified directory.

#### Usage:

```bash
inferia-cli [-c context] run
```

**Example:**

1. Run the inferia application located in `examples` directory:
   ```bash
   inferia-cli -c examples run
   ```

This will:
- Change the current working directory to the configuration path.
- Load the application based on the `inferia.yaml` file.
- Start the FastAPI server for your inference service.

---
