OpenPort.js 🚀

A powerful and easy-to-use AI utilities library that supports multiple AI providers with method chaining.

Installation

npm install openportjs

Quick Start

1. Get your API keys:

   • Get Gemini API Key
   • Get Hugging Face API Key

2. Use in your code:

const OpenPort = require("openportjs");

// Initialize with your API keys
const openport = new OpenPort({
  geminiApiKey: "YOUR_GEMINI_API_KEY",        // Replace with your Gemini API key
  huggingFaceApiKey: "YOUR_HUGGINGFACE_KEY",  // Replace with your Hugging Face key
});

// Try it out! 🎯
openport.chat
  .onSuccess((result) => console.log("🎉 SUCCESS:", result.text))
  .onFailure((error) => console.error("❌ ERROR:", error.message))
  .generate("Hello from OpenPort.js!");

Features

• 🤖 Chat Generation: Generate text responses using Gemini AI
• 🎨 Image Generation: Create images from text descriptions
• 🌐 Translation: Translate text between languages
• 😊 Sentiment Analysis: Analyze text sentiment
• 🎯 Method Chaining: Fluent API for easy use
• ⚡ Streaming Support: Get responses in real-time
• 🔄 Automatic Retries: Built-in retry mechanism
• ⏱️ Timeout Control: Configurable request timeouts

Examples

Basic Chat

openport.chat
  .onSuccess(result => console.log(result.text))
  .generate("What is artificial intelligence?");

Image Generation

openport.image
  .onSuccess(result => console.log("Image URL:", result.url))
  .generate("A beautiful sunset over mountains");

Translation

openport.translate
  .from("en")
  .to("es")
  .translate("Hello, how are you?");

Sentiment Analysis

openport.sentiment
  .analyze("I love using OpenPort.js!");

Configuration Options

const openport = new OpenPort({
  geminiApiKey: "YOUR_GEMINI_API_KEY",
  huggingFaceApiKey: "YOUR_HUGGINGFACE_KEY",
  defaultModel: "gemini-1.5-flash",  // Default AI model
  timeout: 30000,                    // Request timeout in milliseconds
  retries: 3                         // Number of retry attempts
});

Error Handling

openport.chat
  .onSuccess(result => {
    console.log("Success:", result.text);
  })
  .onFailure(error => {
    console.error("Error:", error.message);
  })
  .generate("Your prompt here");

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use this in your projects!

Support

If you find any issues or have questions, please open an issue on GitHub.