nova-orbit 0.1.0__tar.gz

nova_orbit-0.1.0/LICENSE

@@ -0,0 +1,23 @@
+
+#### 中文版 `README_zh.md`
+
+```markdown
+# Nova-Orbit 🪐
+
+> **专为 AI Agent 打造的桌面端终极聊天框架。**
+> *GPU 极速渲染，超乎想象的丝滑与美貌。基于 PySide6 与 QML 构建。*
+
+[English](README.md) | **简体中文**
+
+## 🤔 为什么选择 Nova-Orbit？
+
+基于 Web 的 AI 客户端（如 Gradio）往往卡顿且体验割裂。**Nova-Orbit** 将原生桌面体验与 AI 完美融合：
+
+- 🌱 **“生长式”流式渲染**：文字逐字出现时，气泡高度平滑自适应，滚动条智能跟随，绝不掉帧。
+- 🟩 **原生系统日志**：荧光绿极客日志与聊天气泡共存，完美契合 Agent 的思考与执行过程。
+- 🖱️ **原生桌面交互**：支持原生快捷键、拖拽附件，纯粹的暗黑美学。
+
+## 🚀 安装与使用（仅需 10 行代码）
+
+```bash
+pip install nova-orbit

nova_orbit-0.1.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: nova-orbit
+Version: 0.1.0
+Summary: A stunning, GPU-accelerated AI chat UI framework for PySide6/QML.
+Author-email: eagleye-china <zdt168@sina.cn>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eagleye-china/nova-orbit
+Project-URL: Repository, https://github.com/eagleye-china/nova-orbit
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.6
+Requires-Dist: openai>=1.0
+Requires-Dist: markdown>=3.5
+Dynamic: license-file
+
+# Nova-Orbit 🪐
+
+> **The Ultimate Desktop Chat UI Framework for AI Agents.**  
+> *GPU-accelerated, stunningly beautiful, and unbelievably fast. Built on PySide6 & QML.*
+
+[![PyPI version](https://img.shields.io/badge/pypi-coming_soon-orange)]()
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)]()
+[![License](https://img.shields.io/badge/license-MIT-green)]()
+
+**English** | [简体中文](README_zh.md)
+
+## 🤔 Why Nova-Orbit?
+
+Web-based AI apps (like Gradio or Streamlit) are slow and clunky. **Nova-Orbit** brings AI directly to your desktop with zero compromise:
+
+- 🌱 **"Growing" Streaming**: Bubbles dynamically resize as text generates. Smooth, jank-free scrolling powered by QML.
+- 🟩 **Integrated System Logs**: Neon green terminal-style logs live natively alongside chat bubbles. Perfect for Agentic workflows.
+- 🖱️ **Native Desktop Feel**: Drag & drop files, native shortcuts, and pure dark mode aesthetics.
+
+## 🚀 Install & Use (10 Lines of Code)
+
+```bash
+pip install nova-orbit

nova_orbit-0.1.0/README.md

@@ -0,0 +1,23 @@
+# Nova-Orbit 🪐
+
+> **The Ultimate Desktop Chat UI Framework for AI Agents.**  
+> *GPU-accelerated, stunningly beautiful, and unbelievably fast. Built on PySide6 & QML.*
+
+[![PyPI version](https://img.shields.io/badge/pypi-coming_soon-orange)]()
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)]()
+[![License](https://img.shields.io/badge/license-MIT-green)]()
+
+**English** | [简体中文](README_zh.md)
+
+## 🤔 Why Nova-Orbit?
+
+Web-based AI apps (like Gradio or Streamlit) are slow and clunky. **Nova-Orbit** brings AI directly to your desktop with zero compromise:
+
+- 🌱 **"Growing" Streaming**: Bubbles dynamically resize as text generates. Smooth, jank-free scrolling powered by QML.
+- 🟩 **Integrated System Logs**: Neon green terminal-style logs live natively alongside chat bubbles. Perfect for Agentic workflows.
+- 🖱️ **Native Desktop Feel**: Drag & drop files, native shortcuts, and pure dark mode aesthetics.
+
+## 🚀 Install & Use (10 Lines of Code)
+
+```bash
+pip install nova-orbit

nova_orbit-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68.2", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nova-orbit"
+version = "0.1.0"
+description = "A stunning, GPU-accelerated AI chat UI framework for PySide6/QML."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "eagleye-china", email = "zdt168@sina.cn" }]
+dependencies = [
+    "PySide6>=6.6",
+    "openai>=1.0",
+    "markdown>=3.5"
+]
+
+[project.urls]
+Homepage = "https://github.com/eagleye-china/nova-orbit"
+Repository = "https://github.com/eagleye-china/nova-orbit"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# ✅ 关键：将 QML 文件打包进库中
+[tool.setuptools.package-data]
+nova_orbit = ["qml/*.qml"]

nova_orbit-0.1.0/setup.cfg

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

nova_orbit-0.1.0/src/nova_orbit/__init__.py

@@ -0,0 +1,5 @@
+from .widget import NovaChatWidget
+from .bridge import NovaChatBridge
+
+__version__ = "0.1.0"
+__all__ = ["NovaChatWidget", "NovaChatBridge"]

nova_orbit-0.1.0/src/nova_orbit/bridge.py

@@ -0,0 +1,109 @@
+import threading
+from PySide6.QtCore import QObject, Slot, Property, QAbstractListModel, QModelIndex, Qt, QTimer
+from openai import OpenAI
+
+
+class MessageModel(QAbstractListModel):
+    TextRole = Qt.ItemDataRole.UserRole + 1
+    IsUserRole = Qt.ItemDataRole.UserRole + 2
+    IsSystemRole = Qt.ItemDataRole.UserRole + 3
+
+    def __init__(self):
+        super().__init__()
+        self._messages = []
+
+    def rowCount(self, parent=QModelIndex()):
+        return len(self._messages)
+
+    def data(self, index, role):
+        if not index.isValid(): return None
+        msg = self._messages[index.row()]
+        if role == self.TextRole: return msg.get("text", "")
+        if role == self.IsUserRole: return msg.get("isUser", False)
+        if role == self.IsSystemRole: return msg.get("isSystem", False)
+        return None
+
+    def roleNames(self):
+        return {
+            self.TextRole: b"text",
+            self.IsUserRole: b"isUser",
+            self.IsSystemRole: b"isSystem"
+        }
+
+    def add(self, text, is_user=False, is_sys=False):
+        self.beginInsertRows(QModelIndex(), self.rowCount(), self.rowCount())
+        self._messages.append({"text": text, "isUser": is_user, "isSystem": is_sys})
+        self.endInsertRows()
+
+    def update_last(self, text):
+        if self._messages:
+            self._messages[-1]["text"] = text
+            idx = self.index(len(self._messages) - 1, 0)
+            self.dataChanged.emit(idx, idx, [self.TextRole])
+
+
+class NovaChatBridge(QObject):
+    """核心桥接器：处理 API 请求、数据模型与 QML 的交互"""
+
+    def __init__(self, api_key: str, base_url="https://api.deepseek.com", model="deepseek-chat"):
+        super().__init__()
+        self.api_key = api_key
+        self.base_url = base_url
+        self.model_name = model
+        self.messages = [{"role": "system", "content": "You are a helpful assistant."}]
+
+        self._model = MessageModel()
+        self._model.add("Hello! I am Nova-Orbit. How can I assist you today?", False)
+
+        self._client = OpenAI(api_key=self.api_key, base_url=self.base_url)
+        self._current_ai_text = ""
+        self._is_streaming = False
+
+        self._timer = QTimer()
+        self._timer.setInterval(50)
+        self._timer.timeout.connect(self._update_ui_stream)
+
+    @Property(QObject, constant=True)
+    def messagesModel(self):
+        return self._model
+
+    @Slot(str)
+    def send_user_message(self, text):
+        if not text.strip() or self._is_streaming: return
+
+        self._model.add(text, True)
+        self.messages.append({"role": "user", "content": text})
+
+        self._current_ai_text = ""
+        self._model.add("Thinking...", False)
+        self._is_streaming = True
+        self._timer.start()
+
+        threading.Thread(target=self._fetch_ai_response, daemon=True).start()
+
+    @Slot(str)
+    def add_system_log(self, text):
+        """对外暴露的接口，可用于记录 Agent 的思考过程或工具调用"""
+        self._model.add(f"⚙️ {text}", False, is_sys=True)
+
+    def _fetch_ai_response(self):
+        try:
+            response = self._client.chat.completions.create(
+                model=self.model_name,
+                messages=self.messages,
+                stream=True
+            )
+            for chunk in response:
+                if chunk.choices and chunk.choices[0].delta.content:
+                    self._current_ai_text += chunk.choices[0].delta.content
+            self.messages.append({"role": "assistant", "content": self._current_ai_text})
+        except Exception as e:
+            self._current_ai_text = f"⚠️ API Error: {str(e)}"
+        finally:
+            self._is_streaming = False
+
+    def _update_ui_stream(self):
+        if self._current_ai_text:
+            self._model.update_last(self._current_ai_text)
+        if not self._is_streaming and self._current_ai_text:
+            self._timer.stop()

nova_orbit-0.1.0/src/nova_orbit/qml/NovaAttachmentStrip.qml

@@ -0,0 +1,6 @@
+import QtQuick
+import QtQuick.Controls
+
+Item {
+    // 附件预览区域逻辑，待完善模型绑定
+}

nova_orbit-0.1.0/src/nova_orbit/qml/NovaChatWindow.qml

@@ -0,0 +1,44 @@
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+Item {
+    width: 800; height: 600
+    property color bgColor: "#121212"
+
+    Rectangle {
+        anchors.fill: parent
+        color: bgColor
+
+        ColumnLayout {
+            anchors.fill: parent
+            anchors.margins: 15
+            spacing: 10
+
+            ListView {
+                id: listView
+                Layout.fillWidth: true
+                Layout.fillHeight: true
+                model: bridge.messagesModel
+                spacing: 15
+                clip: true
+
+                delegate: NovaMessageBubble {
+                    width: listView.width
+                    text: model.text
+                    isUser: model.isUser
+                    isSystem: model.isSystem
+                }
+                onCountChanged: listView.positionViewAtEnd()
+            }
+
+            NovaInputBar {
+                id: inputBar
+                Layout.fillWidth: true
+                onSendMessage: (text) => {
+                    bridge.send_user_message(text)
+                }
+            }
+        }
+    }
+}

nova_orbit-0.1.0/src/nova_orbit/qml/NovaInputBar.qml

@@ -0,0 +1,79 @@
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+Item {
+    id: root
+    signal sendMessage(string text)
+    height: Math.min(150, Math.max(60, inputScroll.contentHeight + 20))
+
+    Rectangle {
+        anchors.fill: parent
+        radius: 8
+        color: "#263238"
+        border.color: inputArea.activeFocus ? "#0277BD" : "#37474F"
+        border.width: 1
+        Behavior on border.color { ColorAnimation { duration: 200 } }
+
+        ScrollView {
+            id: inputScroll
+            anchors.left: parent.left
+            anchors.right: sendBtn.left
+            anchors.top: parent.top
+            anchors.bottom: parent.bottom
+            anchors.leftMargin: 12
+            anchors.rightMargin: 10
+            clip: true
+
+            TextArea {
+                id: inputArea
+                placeholderText: "Type a message... (Enter to send, Shift+Enter for new line)"
+                color: "#ECEFF1"
+                font.pixelSize: 14
+                wrapMode: TextArea.Wrap
+                background: Item {}
+                selectByMouse: true
+
+                Keys.onPressed: (event) => {
+                    if (event.key === Qt.Key_Return || event.key === Qt.Key_Enter) {
+                        if (event.modifiers & Qt.ShiftModifier) {
+                            event.accepted = false;
+                        } else {
+                            if (inputArea.text.trim() !== "") {
+                                root.sendMessage(inputArea.text.trim());
+                                inputArea.text = "";
+                            }
+                            event.accepted = true;
+                        }
+                    }
+                }
+            }
+        }
+
+        Button {
+            id: sendBtn
+            text: "🚀"
+            anchors.right: parent.right
+            anchors.rightMargin: 10
+            anchors.bottom: parent.bottom
+            anchors.bottomMargin: 10
+            width: 40
+            height: 40
+            background: Rectangle { color: "#0277BD"; radius: 6 }
+            contentItem: Text { text: "🚀"; anchors.centerIn: parent; font.pixelSize: 18 }
+
+            visible: opacity > 0
+            opacity: inputArea.text.trim() !== "" ? 1.0 : 0.0
+            scale: inputArea.text.trim() !== "" ? 1.0 : 0.5
+            Behavior on opacity { NumberAnimation { duration: 150 } }
+            Behavior on scale { NumberAnimation { duration: 150; easing.type: Easing.OutBack } }
+
+            onClicked: {
+                if (inputArea.text.trim() !== "") {
+                    root.sendMessage(inputArea.text.trim());
+                    inputArea.text = "";
+                }
+            }
+        }
+    }
+}

nova_orbit-0.1.0/src/nova_orbit/qml/NovaMessageBubble.qml

@@ -0,0 +1,34 @@
+import QtQuick
+import QtQuick.Controls
+
+Item {
+    id: root
+    property string text: ""
+    property bool isUser: false
+    property bool isSystem: false
+    height: bubbleRect.height + 10
+
+    Rectangle {
+        id: bubbleRect
+        anchors.right: isUser ? parent.right : undefined
+        anchors.left: isUser ? undefined : parent.left
+        width: Math.min(bubbleText.implicitWidth + 30, root.width * 0.75)
+        height: bubbleText.implicitHeight + 24
+        radius: isSystem ? 4 : 10
+        color: isUser ? "#0277BD" : (isSystem ? "#1E272E" : "#263238")
+        border.color: isSystem ? "#2E7D32" : "transparent"
+        border.width: isSystem ? 1 : 0
+
+        Text {
+            id: bubbleText
+            text: root.text || ""
+            anchors.centerIn: parent
+            width: parent.width - 30
+            wrapMode: Text.Wrap
+            color: isSystem ? "#4CAF50" : "#ECEFF1"
+            font.pixelSize: isSystem ? 12 : 14
+            font.family: isSystem ? "Consolas" : "Microsoft YaHei"
+            textFormat: Text.PlainText
+        }
+    }
+}

nova_orbit-0.1.0/src/nova_orbit/widget.py

@@ -0,0 +1,34 @@
+import os
+from PySide6.QtWidgets import QWidget, QVBoxLayout
+from PySide6.QtQuickWidgets import QQuickWidget
+from PySide6.QtCore import QUrl
+from .bridge import NovaChatBridge
+
+
+class NovaChatWidget(QWidget):
+    """开箱即用的 QWidget 封装，支持直接嵌入任何 PySide 应用"""
+
+    def __init__(self, api_key: str, parent=None):
+        super().__init__(parent)
+        self.setStyleSheet("background-color: #121212;")
+
+        layout = QVBoxLayout(self)
+        layout.setContentsMargins(0, 0, 0, 0)
+
+        self.quick_widget = QQuickWidget()
+        self.quick_widget.setResizeMode(QQuickWidget.ResizeMode.SizeRootObjectToView)
+
+        self.bridge = NovaChatBridge(api_key=api_key)
+
+        # 将 Python 桥接对象注入到 QML 环境
+        engine = self.quick_widget.engine()
+        engine.rootContext().setContextProperty("bridge", self.bridge)
+
+        # 加载打包在库里的 QML 文件
+        qml_path = os.path.join(os.path.dirname(__file__), "qml", "NovaChatWindow.qml")
+        self.quick_widget.setSource(QUrl.fromLocalFile(qml_path))
+
+        layout.addWidget(self.quick_widget)
+
+        # 暴露日志接口给外部
+        self.add_log = self.bridge.add_system_log

nova_orbit-0.1.0/src/nova_orbit.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: nova-orbit
+Version: 0.1.0
+Summary: A stunning, GPU-accelerated AI chat UI framework for PySide6/QML.
+Author-email: eagleye-china <zdt168@sina.cn>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eagleye-china/nova-orbit
+Project-URL: Repository, https://github.com/eagleye-china/nova-orbit
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.6
+Requires-Dist: openai>=1.0
+Requires-Dist: markdown>=3.5
+Dynamic: license-file
+
+# Nova-Orbit 🪐
+
+> **The Ultimate Desktop Chat UI Framework for AI Agents.**  
+> *GPU-accelerated, stunningly beautiful, and unbelievably fast. Built on PySide6 & QML.*
+
+[![PyPI version](https://img.shields.io/badge/pypi-coming_soon-orange)]()
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)]()
+[![License](https://img.shields.io/badge/license-MIT-green)]()
+
+**English** | [简体中文](README_zh.md)
+
+## 🤔 Why Nova-Orbit?
+
+Web-based AI apps (like Gradio or Streamlit) are slow and clunky. **Nova-Orbit** brings AI directly to your desktop with zero compromise:
+
+- 🌱 **"Growing" Streaming**: Bubbles dynamically resize as text generates. Smooth, jank-free scrolling powered by QML.
+- 🟩 **Integrated System Logs**: Neon green terminal-style logs live natively alongside chat bubbles. Perfect for Agentic workflows.
+- 🖱️ **Native Desktop Feel**: Drag & drop files, native shortcuts, and pure dark mode aesthetics.
+
+## 🚀 Install & Use (10 Lines of Code)
+
+```bash
+pip install nova-orbit

nova_orbit-0.1.0/src/nova_orbit.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+src/nova_orbit/__init__.py
+src/nova_orbit/bridge.py
+src/nova_orbit/widget.py
+src/nova_orbit.egg-info/PKG-INFO
+src/nova_orbit.egg-info/SOURCES.txt
+src/nova_orbit.egg-info/dependency_links.txt
+src/nova_orbit.egg-info/requires.txt
+src/nova_orbit.egg-info/top_level.txt
+src/nova_orbit/qml/NovaAttachmentStrip.qml
+src/nova_orbit/qml/NovaChatWindow.qml
+src/nova_orbit/qml/NovaInputBar.qml
+src/nova_orbit/qml/NovaMessageBubble.qml

nova_orbit-0.1.0/src/nova_orbit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nova_orbit-0.1.0/src/nova_orbit.egg-info/requires.txt

@@ -0,0 +1,3 @@
+PySide6>=6.6
+openai>=1.0
+markdown>=3.5

nova_orbit-0.1.0/src/nova_orbit.egg-info/top_level.txt

@@ -0,0 +1 @@
+nova_orbit