neuller 1.0.3__tar.gz

neuller-1.0.3/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: neuller
+Version: 1.0.3
+Summary: Premium SearchCloud built for AI agents and LLMs
+Author: Neuller
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: summary
+
+# Neuller: Search Built for AI 🚀
+
+The official Python SDK for the Neuller SearchCloud—a high-performance search engine built specifically for AI agents and LLMs.
+
+## Installation
+
+```sh
+pip install neuller
+```
+
+## Usage
+
+The primary API for interacting with the Neuller search index is the Responses API. You can generate search results with the code below.
+
+```python
+import os
+from neuller import Neuller
+
+client = Neuller(
+    # This is the default and can be omitted
+    api_key=os.environ.get("API_KEY"), 
+)
+
+# Fetch Search Results
+response = client.responses.create(
+    q='who is the ceo of google',
+    content=True
+)
+
+print(response)
+```
+
+### Retrieving Specific Web Content
+
+If you have a specific URL and want to extract its parsed content using the Neuller SearchCloud:
+
+```python
+# Fetch URL Content
+content_response = client.content.retrieve(
+    url='https://en.wikipedia.org/wiki/Search_engine'
+)
+
+# In Python, print() will show the full dictionary/nested lists automatically
+print(content_response)
+```
+
+## Error Handling
+
+If the Neuller API returns an error representing an invalid request (e.g. invalid API key, missing query), standard Python Exceptions will be raised.
+
+```python
+try:
+    client.responses.create(q='')
+except Exception as e:
+    print(f"Failed: {e}")
+```

neuller-1.0.3/README.md

@@ -0,0 +1,56 @@
+# Neuller: Search Built for AI 🚀
+
+The official Python SDK for the Neuller SearchCloud—a high-performance search engine built specifically for AI agents and LLMs.
+
+## Installation
+
+```sh
+pip install neuller
+```
+
+## Usage
+
+The primary API for interacting with the Neuller search index is the Responses API. You can generate search results with the code below.
+
+```python
+import os
+from neuller import Neuller
+
+client = Neuller(
+    # This is the default and can be omitted
+    api_key=os.environ.get("API_KEY"), 
+)
+
+# Fetch Search Results
+response = client.responses.create(
+    q='who is the ceo of google',
+    content=True
+)
+
+print(response)
+```
+
+### Retrieving Specific Web Content
+
+If you have a specific URL and want to extract its parsed content using the Neuller SearchCloud:
+
+```python
+# Fetch URL Content
+content_response = client.content.retrieve(
+    url='https://en.wikipedia.org/wiki/Search_engine'
+)
+
+# In Python, print() will show the full dictionary/nested lists automatically
+print(content_response)
+```
+
+## Error Handling
+
+If the Neuller API returns an error representing an invalid request (e.g. invalid API key, missing query), standard Python Exceptions will be raised.
+
+```python
+try:
+    client.responses.create(q='')
+except Exception as e:
+    print(f"Failed: {e}")
+```

neuller-1.0.3/neuller/__init__.py

@@ -0,0 +1,71 @@
+import os
+import requests
+
+class NeullerResponses:
+    def __init__(self, client):
+        self._client = client
+
+    def create(self, q: str, content: bool = False):
+        try:
+            response = self._client.post(
+                f"{self._client.base_url}/search",
+                json={"q": q, "content": content}
+            )
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            self._handle_error(e)
+
+    def _handle_error(self, e):
+        if e.response is not None:
+            try:
+                error_data = e.response.json()
+                msg = error_data.get('error', e.response.reason)
+            except ValueError:
+                msg = e.response.text
+            raise Exception(f"Neuller API Error ({e.response.status_code}): {msg}")
+        raise e
+
+class NeullerContent:
+    def __init__(self, client):
+        self._client = client
+
+    def retrieve(self, url: str):
+        try:
+            response = self._client.post(
+                f"{self._client.base_url}/search/content",
+                json={"url": url}
+            )
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            self._handle_error(e)
+
+    def _handle_error(self, e):
+        if e.response is not None:
+            try:
+                error_data = e.response.json()
+                msg = error_data.get('error', e.response.reason)
+            except ValueError:
+                msg = e.response.text
+            raise Exception(f"Neuller API Error ({e.response.status_code}): {msg}")
+        raise e
+
+class Neuller:
+    def __init__(self, api_key: str = None, base_url: str = None):
+        self.api_key = api_key or os.environ.get("API_KEY")
+        if not self.api_key:
+            raise ValueError("The Neuller API Key must be provided (either via api_key or the API_KEY environment variable).")
+        
+        self.base_url = base_url or 'https://api.neuller.com/api/v1'
+        
+        self.session = requests.Session()
+        self.session.headers.update({
+            "x-api-key": self.api_key,
+            "Content-Type": "application/json"
+        })
+        
+        self.post = self.session.post
+        
+        self.responses = NeullerResponses(self)
+        self.content = NeullerContent(self)

neuller-1.0.3/neuller.egg-info/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: neuller
+Version: 1.0.3
+Summary: Premium SearchCloud built for AI agents and LLMs
+Author: Neuller
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: summary
+
+# Neuller: Search Built for AI 🚀
+
+The official Python SDK for the Neuller SearchCloud—a high-performance search engine built specifically for AI agents and LLMs.
+
+## Installation
+
+```sh
+pip install neuller
+```
+
+## Usage
+
+The primary API for interacting with the Neuller search index is the Responses API. You can generate search results with the code below.
+
+```python
+import os
+from neuller import Neuller
+
+client = Neuller(
+    # This is the default and can be omitted
+    api_key=os.environ.get("API_KEY"), 
+)
+
+# Fetch Search Results
+response = client.responses.create(
+    q='who is the ceo of google',
+    content=True
+)
+
+print(response)
+```
+
+### Retrieving Specific Web Content
+
+If you have a specific URL and want to extract its parsed content using the Neuller SearchCloud:
+
+```python
+# Fetch URL Content
+content_response = client.content.retrieve(
+    url='https://en.wikipedia.org/wiki/Search_engine'
+)
+
+# In Python, print() will show the full dictionary/nested lists automatically
+print(content_response)
+```
+
+## Error Handling
+
+If the Neuller API returns an error representing an invalid request (e.g. invalid API key, missing query), standard Python Exceptions will be raised.
+
+```python
+try:
+    client.responses.create(q='')
+except Exception as e:
+    print(f"Failed: {e}")
+```

neuller-1.0.3/neuller.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+neuller/__init__.py
+neuller.egg-info/PKG-INFO
+neuller.egg-info/SOURCES.txt
+neuller.egg-info/dependency_links.txt
+neuller.egg-info/requires.txt
+neuller.egg-info/top_level.txt

neuller-1.0.3/neuller.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

neuller-1.0.3/neuller.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

neuller-1.0.3/neuller.egg-info/top_level.txt

@@ -0,0 +1 @@
+neuller

neuller-1.0.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

neuller-1.0.3/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='neuller',
+    version='1.0.3',
+    description='Premium SearchCloud built for AI agents and LLMs',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
+    author='Neuller',
+    packages=find_packages(),
+    install_requires=[
+        'requests>=2.25.0',
+    ],
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+    ],
+)