Your AI's Bridge to macOS 让您的 AI 桥接到 macOS
Orbit is a framework-agnostic macOS automation toolkit that empowers AI agents to seamlessly interact with macOS through AppleScript.
- 100+ Satellites - Comprehensive macOS automation tools
- 4-Tier Safety - Built-in security system (SAFE/MODERATE/DANGEROUS/CRITICAL)
- Framework Agnostic - Works with OpenAI, LangChain, Anthropic, and custom agents
- CLI Tool Included - Convenient terminal access to all satellites
- Bilingual Docs - Complete documentation in English and Chinese
# Install
pip install orbit-macos
# Basic usage
from orbit import MissionControl
from orbit.satellites import all_satellites
mission = MissionControl()
mission.register_constellation(all_satellites)
result = mission.launch("system_get_info", {})- Quick Start Guide - Get up and running in 5 minutes
- API Reference - Complete API documentation
- CLI Reference - Command-line tool documentation
- Design Document - Architecture and technical details
- Security Model - Safety system and best practices
- Satellites Reference - Complete list of all 104 satellites
- Terminology - Orbit naming conventions
- Contributing Guide - How to contribute
- CLI Examples - CLI usage examples
- Python Examples - Code examples for various frameworks
Orbit 是一个框架无关的 macOS 自动化工具包，通过 AppleScript 赋能 AI 代理无缝操作 macOS。
- 100+ 卫星工具 - 全面的 macOS 自动化能力
- 四级安全系统 - 内置安全保护（安全/中等/危险/严重）
- 框架无关 - 支持 OpenAI、LangChain、Anthropic 和自定义代理
- CLI 工具 - 方便的终端访问
- 双语文档 - 完整的中英文文档
# 安装
pip install orbit-macos
# 基础用法
from orbit import MissionControl
from orbit.satellites import all_satellites
mission = MissionControl()
mission.register_constellation(all_satellites)
result = mission.launch("system_get_info", {})Orbit provides 104 satellites across 12 categories:
| Category | Count | Satellites |
|---|---|---|
| System | 24 | System info, clipboard, notifications, screenshots... |
| Files | 10 | File operations: read, write, delete, search... |
| Notes | 7 | Create, read, update, delete, search notes |
| Reminders | 6 | Manage reminders and lists |
| Calendar | 4 | Create and manage events |
| 6 | Send and read emails | |
| Safari | 12 | Browser automation, tabs, search |
| Music | 11 | Playback control and library |
| Finder | 6 | File manager operations |
| Contacts | 4 | Search and retrieve contacts |
| WiFi | 6 | Network management |
| Apps | 8 | Application lifecycle |
View complete satellite list → | 查看完整卫星列表 →
Orbit implements a 4-tier safety system:
| Level | Description | Examples | Action |
|---|---|---|---|
| SAFE | Read-only operations | Get info, list files | ✅ Allow |
| MODERATE | Create/modify | Write file, create note | |
| DANGEROUS | Delete operations | Delete file, empty trash | |
| CRITICAL | System-level | System file modification | 🚫 Deny |
Learn more about security → | 了解安全详情 →
Orbit integrates seamlessly with popular AI frameworks:
from orbit import MissionControl
from orbit.satellites import all_satellites
mission = MissionControl()
mission.register_constellation(all_satellites)
functions = mission.export_openai_functions()
# Use with OpenAI API
response = openai.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "What's my macOS version?"}],
functions=functions
)from langchain.agents import initialize_agent, AgentType
from langchain.tools import StructuredTool
from orbit import MissionControl
mission = MissionControl()
mission.register_constellation(all_satellites)
tools = [
StructuredTool.from_function(
func=lambda **kwargs: mission.launch(sat.name, kwargs),
name=sat.name,
description=sat.description
)
for sat in mission.constellation.list_all()
]
agent = initialize_agent(tools, llm, agent=AgentType.OPENAI_FUNCTIONS)More integration examples → | 更多集成示例 →
- Quick Start - 5-minute tutorial
- API Reference - Complete API docs
- CLI Reference - CLI tool guide
- Design Doc - Technical architecture
- Security Model - Safety system
- Contributing - Contribution guide
View all documentation → | 查看所有文档 →
- Version: 1.0.0
- Release Date: January 27, 2026
- Total Satellites: 104
- Categories: 12
- Python Code: 5,069 lines
- Test Cases: 272
- Test Coverage: 65% code / 95% functionality
- Documentation Files: 23 markdown files (bilingual)
Contributions are welcome! Please read our Contributing Guide | 贡献指南.
# Clone repository
git clone https://github.com/xiaoxiath/orbit.git
cd orbit
# Install dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Run with coverage
pytest --cov=orbit --cov-report=htmlMIT License - see LICENSE for details.
Built with ❤️ for the macOS automation community.
Orbit: Your AI's Bridge to macOS 🛸
- 📖 All Documentation Index | 文档索引
- 🚀 Quick Start | 快速入门
- 📚 API Reference | API 参考
- 🛡️ Security Model | 安全模型
- 🖥️ CLI Tool | 命令行工具
- 📋 Satellites List | 卫星列表
- 🎯 Test Coverage | 测试覆盖率
Version: 1.0.0 | Last Updated: 2026-01-27 | Status: ✅ Production Ready