memora-orbis 0.1.0__tar.gz

memora_orbis-0.1.0/LICENSE.md

@@ -0,0 +1,21 @@
+# ORBIS BY MEMORA — COMMERCIAL & COMMUNITY EVALUATION LICENSE (v1.0)
+Copyright (c) 2026 Memora Company (https://memora.company). All rights reserved.
+
+## 1. Permitted Uses (Community & Evaluation)
+Subject to the terms and conditions of this License, Memora Company grants you a limited, non-exclusive, non-transferable license to:
+- Download, install, and execute Orbis by Memora for personal development, learning, testing, and evaluation purposes.
+- Integrate Orbis with local autonomous AI agents (e.g. LangChain, Browser-Use, CrewAI, Stagehand) in non-production, evaluation environments.
+
+## 2. Commercial & Production Use Restriction
+- Commercial, business, or production deployment requires a commercial enterprise subscription or written license agreement from Memora Company.
+- If your organization generates commercial revenue or uses Orbis in a production environment, you must obtain a commercial license at:
+  https://orbis.memora.company or by contacting enterprise@memora.company.
+
+## 3. General Prohibitions
+You may NOT:
+- Reverse-engineer, decompile, disassemble, or attempt to derive source code from any distributed binary files or obfuscated JavaScript.
+- Resell, sublicense, rent, lease, or host Orbis as a competing multi-tenant commercial cloud service without explicit written authorization from Memora Company.
+- Alter, remove, or obscure any copyright notices, trademarks, or proprietary markings.
+
+## 4. Disclaimer of Warranty
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MEMORA COMPANY BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES.

memora_orbis-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: memora-orbis
+Version: 0.1.0
+Summary: Orbis by Memora — Official Python SDK for Agentic Browser (Browser-Use, LangChain, CrewAI)
+Author-email: Memora <support@memora.company>
+License: Commercial / Proprietary - see LICENSE.md
+Project-URL: Homepage, https://orbis.memora.company
+Project-URL: Company, https://memora.company
+Project-URL: Repository, https://github.com/yadavmandeep/memora-browser
+Keywords: headless-browser,orbis,memora,cdp,ai-agents,browser-use,langchain,web-automation
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Dynamic: license-file
+
+# 🪐 Orbis by Memora — Python SDK
+> **The Agentic Browser. Built for Autonomous Intelligence.**  
+> 🌐 **Website:** [orbis.memora.company](https://orbis.memora.company) • **Company:** [memora.company](https://memora.company)  
+> ⚡ **Core Engine:** Memora Browser Engine (MBE)
+
+Official Python SDK for **Orbis by Memora**, the agent-native, ultra-lightweight headless browser engine.
+
+## Installation
+
+```bash
+pip install memora-orbis
+```
+
+## Quick Start
+
+```python
+from orbis import OrbisAgent  # or: from memora import MemoraAgent
+
+# Connect to running Orbis daemon (started via `npx memora-orbis --port 9222`)
+agent = OrbisAgent.connect("http://localhost:9222")
+
+# Navigate and get compact LLM action map (<1000 tokens)
+snap = agent.goto("https://example.com")
+print(f"Title: {snap.title} | Tokens: ~{snap.token_estimate}")
+print(snap.action_map_text)
+
+# Direct interaction via @actionId, Playwright label, or CSS
+agent.act("@1")
+agent.act("label:Email Address", "agent@memora.company")
+agent.act("text=Sign In")
+
+# Check state changes between turns
+diff = agent.diff()
+print(diff["diff"]["summary"])
+
+# Autonomous self-healing form fill (supports labels, placeholders, @ids, #ids)
+agent.fill_form({"label:Username": "agent_007", "placeholder:Password": "secret"}, submit="text=Sign In")
+```
+
+## Integration with Browser-Use
+
+```python
+from orbis import OrbisAgent
+from browser_use import Agent
+from langchain_openai import ChatOpenAI
+
+agent = OrbisAgent.connect("http://localhost:9222")
+
+# Browser-Use automatically connects over Orbis's ultra-lightweight CDP
+browser_agent = Agent(
+    task="Search news for AI agent announcements",
+    llm=ChatOpenAI(model="gpt-4o"),
+    browser_context_kwargs=agent.to_browser_use()
+)
+```
+
+## Integration with LangChain
+
+```python
+from orbis import OrbisAgent
+
+agent = OrbisAgent.connect("http://localhost:9222")
+tools = agent.to_langchain_tools()
+# Exported LangChain tools: memora_navigate, memora_act, memora_diff
+```
+
+## 🏢 About Memora
+
+**[Memora](https://memora.company/)** is an AI organizational memory and knowledge management platform. It connects conversations, code, tickets, documents, and meetings into a shared, verifiable intelligence layer.
+
+Orbis is Memora's official agentic browser engine, giving AI workflows and multi-agent fleets reliable, token-condensed, and stealth-native web execution.
+
+Visit **[memora.company](https://memora.company/)** to learn more.

memora_orbis-0.1.0/README.md

@@ -0,0 +1,73 @@
+# 🪐 Orbis by Memora — Python SDK
+> **The Agentic Browser. Built for Autonomous Intelligence.**  
+> 🌐 **Website:** [orbis.memora.company](https://orbis.memora.company) • **Company:** [memora.company](https://memora.company)  
+> ⚡ **Core Engine:** Memora Browser Engine (MBE)
+
+Official Python SDK for **Orbis by Memora**, the agent-native, ultra-lightweight headless browser engine.
+
+## Installation
+
+```bash
+pip install memora-orbis
+```
+
+## Quick Start
+
+```python
+from orbis import OrbisAgent  # or: from memora import MemoraAgent
+
+# Connect to running Orbis daemon (started via `npx memora-orbis --port 9222`)
+agent = OrbisAgent.connect("http://localhost:9222")
+
+# Navigate and get compact LLM action map (<1000 tokens)
+snap = agent.goto("https://example.com")
+print(f"Title: {snap.title} | Tokens: ~{snap.token_estimate}")
+print(snap.action_map_text)
+
+# Direct interaction via @actionId, Playwright label, or CSS
+agent.act("@1")
+agent.act("label:Email Address", "agent@memora.company")
+agent.act("text=Sign In")
+
+# Check state changes between turns
+diff = agent.diff()
+print(diff["diff"]["summary"])
+
+# Autonomous self-healing form fill (supports labels, placeholders, @ids, #ids)
+agent.fill_form({"label:Username": "agent_007", "placeholder:Password": "secret"}, submit="text=Sign In")
+```
+
+## Integration with Browser-Use
+
+```python
+from orbis import OrbisAgent
+from browser_use import Agent
+from langchain_openai import ChatOpenAI
+
+agent = OrbisAgent.connect("http://localhost:9222")
+
+# Browser-Use automatically connects over Orbis's ultra-lightweight CDP
+browser_agent = Agent(
+    task="Search news for AI agent announcements",
+    llm=ChatOpenAI(model="gpt-4o"),
+    browser_context_kwargs=agent.to_browser_use()
+)
+```
+
+## Integration with LangChain
+
+```python
+from orbis import OrbisAgent
+
+agent = OrbisAgent.connect("http://localhost:9222")
+tools = agent.to_langchain_tools()
+# Exported LangChain tools: memora_navigate, memora_act, memora_diff
+```
+
+## 🏢 About Memora
+
+**[Memora](https://memora.company/)** is an AI organizational memory and knowledge management platform. It connects conversations, code, tickets, documents, and meetings into a shared, verifiable intelligence layer.
+
+Orbis is Memora's official agentic browser engine, giving AI workflows and multi-agent fleets reliable, token-condensed, and stealth-native web execution.
+
+Visit **[memora.company](https://memora.company/)** to learn more.

memora_orbis-0.1.0/memora/__init__.py

@@ -0,0 +1,3 @@
+from .agent import OrbisAgent, OrbisSnapshot, MemoraAgent, MemoraSnapshot
+
+__all__ = ["OrbisAgent", "OrbisSnapshot", "MemoraAgent", "MemoraSnapshot"]

memora_orbis-0.1.0/memora/agent.py

@@ -0,0 +1,166 @@
+import os
+import json
+import urllib.request
+import urllib.parse
+from typing import Dict, Any, Optional, List
+
+class OrbisSnapshot:
+    def __init__(self, data: Dict[str, Any]):
+        self.raw = data
+        self.url = data.get("url", "")
+        self.title = data.get("title", "")
+        self.markdown = data.get("markdown", "")
+        self.action_map_text = data.get("actionMapText", "")
+        self.actions = data.get("actions", [])
+        self.token_estimate = data.get("tokenEstimate", 0)
+        self.interactive_count = data.get("interactiveCount", 0)
+
+    def __repr__(self) -> str:
+        return f"<OrbisSnapshot '{self.title}' actions={self.interactive_count} tokens={self.token_estimate}>"
+
+class OrbisAgent:
+    """
+    🪐 OrbisAgent — Official Python Agent SDK for Orbis by Memora (https://orbis.memora.company).
+    Provides 1-line connection and high-velocity agentic browsing for Browser-Use,
+    LangChain, CrewAI, AutoGen, and independent LLM agents.
+    """
+
+    def __init__(self, base_url: str = "http://localhost:9222", api_key: Optional[str] = None):
+        self.base_url = base_url.rstrip("/")
+        self.api_key = api_key or os.environ.get("ORBIS_API_KEY") or os.environ.get("MEMORA_API_KEY")
+
+    @classmethod
+    def connect(cls, base_url: str = "http://localhost:9222", api_key: Optional[str] = None) -> "OrbisAgent":
+        """Connect to a running Orbis Browser daemon."""
+        agent = cls(base_url, api_key=api_key)
+        # Verify connectivity
+        headers = {}
+        if agent.api_key:
+            headers["x-api-key"] = agent.api_key
+            headers["Authorization"] = f"Bearer {agent.api_key}"
+        req = urllib.request.Request(f"{agent.base_url}/json/version", headers=headers)
+        with urllib.request.urlopen(req, timeout=5) as res:
+            if res.status != 200:
+                raise ConnectionError(f"Orbis Browser did not respond on {base_url} (HTTP {res.status})")
+        return agent
+
+    def _make_headers(self, extra: Optional[Dict[str, str]] = None) -> Dict[str, str]:
+        headers = extra or {}
+        if self.api_key:
+            headers["x-api-key"] = self.api_key
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        return headers
+
+    def _get(self, path: str, params: Optional[Dict[str, str]] = None) -> Dict[str, Any]:
+        url = f"{self.base_url}{path}"
+        if params:
+            url += f"?{urllib.parse.urlencode(params)}"
+        req = urllib.request.Request(url, headers=self._make_headers())
+        with urllib.request.urlopen(req, timeout=15) as res:
+            return json.loads(res.read().decode("utf-8"))
+
+    def _post(self, path: str, data: Dict[str, Any], params: Optional[Dict[str, str]] = None) -> Dict[str, Any]:
+        url = f"{self.base_url}{path}"
+        if params:
+            url += f"?{urllib.parse.urlencode(params)}"
+        payload = json.dumps(data).encode("utf-8")
+        headers = self._make_headers({"Content-Type": "application/json"})
+        req = urllib.request.Request(
+            url,
+            data=payload,
+            headers=headers,
+            method="POST"
+        )
+        with urllib.request.urlopen(req, timeout=15) as res:
+            return json.loads(res.read().decode("utf-8"))
+
+    def goto(self, url: str) -> OrbisSnapshot:
+        """Navigate to target URL and return distilled semantic snapshot."""
+        data = self._get("/orbis/goto", {"url": url})
+        return OrbisSnapshot(data.get("snapshot", data))
+
+    def snapshot(self, focus_selector: Optional[str] = None, exclude_selectors: Optional[List[str]] = None) -> OrbisSnapshot:
+        """Fetch current semantic snapshot with numbered action IDs (@1, @2, ...)."""
+        params = {}
+        if focus_selector:
+            params["focus"] = focus_selector
+        if exclude_selectors:
+            params["exclude"] = ",".join(exclude_selectors)
+        data = self._get("/orbis/snapshot", params)
+        return OrbisSnapshot(data)
+
+    def markdown(self) -> str:
+        """Return clean, distilled Markdown representation."""
+        url = f"{self.base_url}/orbis/snapshot?format=markdown"
+        req = urllib.request.Request(url, headers=self._make_headers())
+        with urllib.request.urlopen(req, timeout=10) as res:
+            return res.read().decode("utf-8")
+
+    def diff(self) -> Dict[str, Any]:
+        """Compute state difference from the previous action (added, removed, mutated interactives)."""
+        return self._get("/orbis/diff")
+
+    def act(self, action_id: str, text: Optional[str] = None) -> Dict[str, Any]:
+        """Click or type into an element using its @actionId (e.g. '@1', '@2') or selector."""
+        payload: Dict[str, Any] = {"actionId": action_id}
+        if text is not None:
+            payload["type"] = "type"
+            payload["text"] = text
+        else:
+            payload["type"] = "click"
+        return self._post("/orbis/act", payload)
+
+    def select_option(self, target: str, value_or_text: str) -> Dict[str, Any]:
+        """Select a dropdown option by value or visible text using any locator format."""
+        return self._post("/orbis/select-option", {"target": target, "value": value_or_text})
+
+    def fill_form(self, fields: Dict[str, str], submit: bool = True) -> Dict[str, Any]:
+        """Fill multiple fields in one atomic turn and optionally submit."""
+        return self._post("/orbis/fill-form", {"fields": fields, "submit": submit})
+
+    def save_session(self, file_path: str) -> Dict[str, Any]:
+        """Save cookies, localStorage, and sessionStorage to a file."""
+        return self._post("/orbis/session/save", {"filePath": file_path})
+
+    def load_session(self, file_path: str) -> Dict[str, Any]:
+        """Load session from a file."""
+        return self._post("/orbis/session", {"filePath": file_path})
+
+    def to_browser_use(self) -> Dict[str, Any]:
+        """Return configuration dictionary for Browser-Use in Python."""
+        return {
+            "cdp_url": self.base_url,
+            "disable_security": True
+        }
+
+    def to_langchain_tools(self) -> List[Any]:
+        """Return LangChain StructuredTool definitions."""
+        try:
+            from langchain.tools import tool
+
+            @tool
+            def orbis_navigate(url: str) -> str:
+                """Navigate to a URL and return distilled snapshot and action map."""
+                snap = self.goto(url)
+                return f"{snap.action_map_text}\n\n=== CONTENT ===\n{snap.markdown[:4000]}"
+
+            @tool
+            def orbis_act(action_id: str, text: Optional[str] = None) -> str:
+                """Click or type into an element by its action ID (@1, @2)."""
+                res = self.act(action_id, text)
+                diff = self.diff()
+                return f"Action {action_id} result: {res.get('success')}\nDiff summary:\n{diff.get('diff', {}).get('summary', '')}"
+
+            @tool
+            def orbis_diff() -> str:
+                """Check what changed on the page after the last action."""
+                d = self.diff().get("diff", {})
+                return d.get("summary", "No changes detected.")
+
+            return [orbis_navigate, orbis_act, orbis_diff]
+        except ImportError:
+            raise ImportError("LangChain is not installed. Install via `pip install langchain` to use to_langchain_tools().")
+
+# Backward Compatibility Aliases
+MemoraSnapshot = OrbisSnapshot
+MemoraAgent = OrbisAgent

memora_orbis-0.1.0/memora_orbis.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: memora-orbis
+Version: 0.1.0
+Summary: Orbis by Memora — Official Python SDK for Agentic Browser (Browser-Use, LangChain, CrewAI)
+Author-email: Memora <support@memora.company>
+License: Commercial / Proprietary - see LICENSE.md
+Project-URL: Homepage, https://orbis.memora.company
+Project-URL: Company, https://memora.company
+Project-URL: Repository, https://github.com/yadavmandeep/memora-browser
+Keywords: headless-browser,orbis,memora,cdp,ai-agents,browser-use,langchain,web-automation
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Dynamic: license-file
+
+# 🪐 Orbis by Memora — Python SDK
+> **The Agentic Browser. Built for Autonomous Intelligence.**  
+> 🌐 **Website:** [orbis.memora.company](https://orbis.memora.company) • **Company:** [memora.company](https://memora.company)  
+> ⚡ **Core Engine:** Memora Browser Engine (MBE)
+
+Official Python SDK for **Orbis by Memora**, the agent-native, ultra-lightweight headless browser engine.
+
+## Installation
+
+```bash
+pip install memora-orbis
+```
+
+## Quick Start
+
+```python
+from orbis import OrbisAgent  # or: from memora import MemoraAgent
+
+# Connect to running Orbis daemon (started via `npx memora-orbis --port 9222`)
+agent = OrbisAgent.connect("http://localhost:9222")
+
+# Navigate and get compact LLM action map (<1000 tokens)
+snap = agent.goto("https://example.com")
+print(f"Title: {snap.title} | Tokens: ~{snap.token_estimate}")
+print(snap.action_map_text)
+
+# Direct interaction via @actionId, Playwright label, or CSS
+agent.act("@1")
+agent.act("label:Email Address", "agent@memora.company")
+agent.act("text=Sign In")
+
+# Check state changes between turns
+diff = agent.diff()
+print(diff["diff"]["summary"])
+
+# Autonomous self-healing form fill (supports labels, placeholders, @ids, #ids)
+agent.fill_form({"label:Username": "agent_007", "placeholder:Password": "secret"}, submit="text=Sign In")
+```
+
+## Integration with Browser-Use
+
+```python
+from orbis import OrbisAgent
+from browser_use import Agent
+from langchain_openai import ChatOpenAI
+
+agent = OrbisAgent.connect("http://localhost:9222")
+
+# Browser-Use automatically connects over Orbis's ultra-lightweight CDP
+browser_agent = Agent(
+    task="Search news for AI agent announcements",
+    llm=ChatOpenAI(model="gpt-4o"),
+    browser_context_kwargs=agent.to_browser_use()
+)
+```
+
+## Integration with LangChain
+
+```python
+from orbis import OrbisAgent
+
+agent = OrbisAgent.connect("http://localhost:9222")
+tools = agent.to_langchain_tools()
+# Exported LangChain tools: memora_navigate, memora_act, memora_diff
+```
+
+## 🏢 About Memora
+
+**[Memora](https://memora.company/)** is an AI organizational memory and knowledge management platform. It connects conversations, code, tickets, documents, and meetings into a shared, verifiable intelligence layer.
+
+Orbis is Memora's official agentic browser engine, giving AI workflows and multi-agent fleets reliable, token-condensed, and stealth-native web execution.
+
+Visit **[memora.company](https://memora.company/)** to learn more.

memora_orbis-0.1.0/memora_orbis.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE.md
+README.md
+pyproject.toml
+memora/__init__.py
+memora/agent.py
+memora_orbis.egg-info/PKG-INFO
+memora_orbis.egg-info/SOURCES.txt
+memora_orbis.egg-info/dependency_links.txt
+memora_orbis.egg-info/top_level.txt
+orbis/__init__.py

memora_orbis-0.1.0/memora_orbis.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

memora_orbis-0.1.0/memora_orbis.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+memora
+orbis

memora_orbis-0.1.0/orbis/__init__.py

@@ -0,0 +1,3 @@
+from memora.agent import OrbisAgent, OrbisSnapshot, MemoraAgent, MemoraSnapshot
+
+__all__ = ["OrbisAgent", "OrbisSnapshot", "MemoraAgent", "MemoraSnapshot"]

memora_orbis-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "memora-orbis"
+version = "0.1.0"
+description = "Orbis by Memora — Official Python SDK for Agentic Browser (Browser-Use, LangChain, CrewAI)"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Commercial / Proprietary - see LICENSE.md" }
+authors = [
+    { name = "Memora", email = "support@memora.company" }
+]
+keywords = ["headless-browser", "orbis", "memora", "cdp", "ai-agents", "browser-use", "langchain", "web-automation"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+]
+
+[project.urls]
+Homepage = "https://orbis.memora.company"
+Company = "https://memora.company"
+Repository = "https://github.com/yadavmandeep/memora-browser"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["memora*", "orbis*"]

memora_orbis-0.1.0/setup.cfg

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