ai-openai 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joltz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# openai-helper
+
+An **unofficial helper API** for OpenAI-like models hosted on HuggingFace.  
+Simplifies calling AI models for chat responses, learning advice, and more.
+
+---
+
+## Features
+
+- Free HuggingFace-hosted OpenAI-like model  
+- SkillGap AI system prompt built-in  
+- Simple JSON API  
+- Easy integration with websites, Discord bots, or other apps
+
+---
+## Setup
+
+1. Get your free HuggingFace token at https://huggingface.co/settings/tokens
+2. Input your HuggingFace token in the HUGGINGFACE variable.
+3. Then run your project.
+
+## Usage
+
+const { chat } = require("ai-openai"); // import from npm package
+require("dotenv").config();
+
+(async () => {
+  try {
+    const reply = await chat("What is x if y = 2x + 3 and y = 7?"); // call function directly
+    console.log("AI reply:", reply);
+  } catch (err) {
+    console.error(err);
+  }
+})();
+
+## Installation
+
+```bash
+npm install openai-helper

package/index.js

@@ -0,0 +1,46 @@
+const axios = require("axios");
+require("dotenv").config();
+
+/**
+ * Send a message to HuggingFace chat API and get a reply
+ * @param {string} message - The user's message
+ * @param {string} token - HuggingFace API token (optional, defaults to env)
+ * @returns {Promise<string>} - AI reply
+ */
+async function chat(message, token = process.env.HUGGINGFACE) {
+  if (!token) throw new Error("HuggingFace token is required");
+  if (!message) throw new Error("Message is required");
+
+  try {
+    const response = await axios.post(
+      "https://router.huggingface.co/v1/chat/completions",
+      {
+        model: "openai/gpt-oss-120b" , // or any HF chat-compatible model
+        messages: [
+          {
+            role: "system",
+            content: `
+You are a helpful assistant.
+`
+          },
+          { role: "user", content: message }
+        ]
+      },
+      {
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "Content-Type": "application/json"
+        }
+      }
+    );
+
+    const aiText = response.data?.choices?.[0]?.message?.content || "No response";
+    return aiText;
+
+  } catch (err) {
+    console.error(err.response?.data || err.message);
+    throw new Error("Something went wrong with the AI API call");
+  }
+}
+
+module.exports = { chat };

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "ai-openai",
+  "version": "1.0.3",
+  "description": "Unofficial helper for OpenAI-like models via HuggingFace",
+  "main": "index.js",
+  "scripts": {
+    "start": "node test.js"
+  },
+  "keywords": [
+    "openai",
+    "huggingface",
+    "ai",
+    "chat"
+  ],
+  "author": "Joltz",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.5.0",
+    "dotenv": "^16.3.1"
+  }
+}