netra-cv 0.1.0

Netra: Mata Digital untuk Pemrosesan Citra Nusantara

Netra: Digital Eye for Image Processing

Bahasa Indonesia

Netra (Sanskrit/Javanese: "Eye") is a modern Python library designed to simplify image processing and computer vision. Inspired by the philosophy of Saka-NLP, Netra serves as a clean, modular, and high-performance visual infrastructure pillar.

---

✨ Key Features

• Clean API (Façade Pattern): Access all advanced features through a single Netra class.
• Intelligent Auto-Correction: Automatically straightens skewed images with auto_rotate.
• One-Line Preprocessing: Clean images for OCR or Deep Learning in a single line.
• Smart Resizing: Resize images without breaking the aspect ratio.
• Data Augmentation: Includes noise injection and lighting simulation for AI datasets.
• Computer Vision Plugins: Built-in support for face detection, shape detection, and color isolation.
• Lightweight Algorithms: Includes Pencil Sketch, Cartoon, Sepia, and Contrast Enhancement.

---

🚀 Installation Guide

Ensure you have Python 3.8 or newer.

pip install netra-cv

For installation from source (development version):

git clone https://github.com/Muhammad-Ikhwan-Fathulloh/Netra-CV.git
cd Netra-CV
pip install -e .

---

📖 Usage Examples

Netra is designed to keep your code clean and readable.

1. Basics & Preprocessing

from netra import Netra

# Load image
img = Netra.load("photo.jpg")

# Clean image (Grayscale -> Blur -> Otsu Threshold)
cleaned = Netra.clean_image(img)

# Automatically straighten image skew
straightened = Netra.auto_rotate(img)

2. Geometric Manipulation

# Smart resize (preserving aspect ratio)
resized = Netra.smart_resize(img, width=800)

# Center crop for AI model input (TensorFlow/PyTorch)
cropped = Netra.center_crop(img, size=(224, 224))

# Flip/Mirror (horizontal, vertical, both)
mirrored = Netra.flip(img, mode="horizontal")

3. Effects & Enhancement (Lightweight Algorithms)

# Intelligent contrast enhancement (CLAHE)
enhanced = Netra.enhance_contrast(img)

# Vintage Sepia Filter
sepia = Netra.to_sepia(img)

# Pencil Sketch Effect
sketch = Netra.to_sketch(img)

# Cartoon Effect
cartoon = Netra.to_cartoon(img)

4. Color & Shape Vision

# Isolate specific colors (green, blue, red, yellow)
only_green = Netra.isolate_color(img, "green")

# Detect shapes (Triangle, Square, Circle)
shapes = Netra.find_shapes(img)

# Add Text Watermark
marked = Netra.watermark(img, "NETRA-CV", position=(50, 50))

---

🛠️ Command Line Interface (CLI)

Netra can also be used directly from the Command Line:

# View help
netra --help

# Get image info
netra --info sample.jpg

# Sketch conversion
netra --sketch photo.jpg --output result_sketch.jpg

# Quick resize
netra --resize sample.jpg --width 1024 --output resized.jpg

---

❤️ Credits & Contributors

• Lead Architect: Muhammad Ikhwan Fathulloh
• Open-source licensed under MIT License.

---

"Netra provides eyes to your code."