isA_Data
Cloud Data Analytics & Processing Center
🎯 Purpose
独立的数据分析云服务，处理数据处理、分析、可视化等任务。
从 isA_MCP/tools/services/data_analytics_service 迁移而来，提供 API 服务。
🏗️ Architecture
isA_Data/
├── app/
│ ├── main.py # FastAPI 主服务
│ ├── config.py # 配置管理
│ └── api/
│ ├── analytics.py # 数据分析端点
│ ├── processing.py # 数据处理端点
│ └── visualization.py # 数据可视化端点
│
├── services/
│ ├── analytics/ # [迁移自 isA_MCP]
│ │ ├── pandas_ops.py # Pandas 操作
│ │ ├── statistical.py # 统计分析
│ │ └── ml_analysis.py # ML 分析
│ │
│ ├── processing/
│ │ ├── etl.py # ETL 处理
│ │ ├── cleaning.py # 数据清洗
│ │ └── transformation.py # 数据转换
│ │
│ └── storage/
│ ├── database.py # 数据库操作
│ └── cache.py # 缓存管理
│
├── core/
│ ├── logging.py
│ └── clients/
│ └── model_client.py # ISA Model 客户端
│
├── deployment/
│ ├── docker/
│ │ └── Dockerfile
│ └── kubernetes/
│ └── deployment.yaml
│
├── tests/
│ └── test_analytics.py
│
├── requirements.txt
└── README.md
📡 API Endpoints
Data Analytics
POST /api/v1/data/analyze
POST /api/v1/data/statistics
POST /api/v1/data/ml/predict
Data Processing
POST /api/v1/data/clean
POST /api/v1/data/transform
POST /api/v1/data/aggregate
Data Visualization
POST /api/v1/data/visualize/chart
POST /api/v1/data/visualize/dashboard
📦 Install (PyPI)
isa-data is published to PyPI — install it as an SDK to consume the canonical
data-product contracts and the lifted data-product DevEx engines:
pip install "isa-data>=1.0.1"
Use >=1.0.1: 1.0.0 eagerly imported
intelligent_query_service→deltalake(not a dependency), so the lightweight dataphin engines failed to import; #457 made that import lazy.
Data-product DevEx kit (consumed by towers, e.g. sn_commercial_tower)
The SDK ships the tower-agnostic engines a tower delegates to (see
docs/data-products/tower-onboarding.md
and ADR-0006):
from isa_data.contracts.data_products import build_artifact_inventory, ArtifactSurfaceSpec
from isa_data.services.data_fabric_service.federation.dataphin.scaffolding import scaffold
from isa_data.services.data_fabric_service.federation.dataphin.handoff import generate_handoff
from isa_data.services.data_fabric_service.federation.dataphin.deploy import build_plan_from_contract
from isa_data.services.product_spec.deploy_contract import load_ct_contract
These import without the heavy data-infra stack (deltalake/duckdb) — that is pulled
only if you use IntelligentQueryService.
🚀 Usage
As Standalone Service
# Start server (FastAPI app)
uvicorn isa_data.main:app --host 0.0.0.0 --port 8084
# Or with Docker
docker-compose up
Called from isA_MCP
# isA_MCP 中通过 API 调用
from tools.services.data_analytics_service import ISA_Data_Client
client = ISA_Data_Client(base_url="http://localhost:8001")
result = await client.analyze_data(
data=df,
analysis_type="descriptive"
)
💡 Benefits
- 专注: 专门处理数据相关任务
- 性能: 可以部署在大内存机器上处理大数据
- 隔离: 数据处理故障不影响 MCP 主服务
- 可复用: 多个服务都可以调用数据分析能力
- 扩展: 未来可以添加更多数据源和分析能力
🔄 Migration Status
- Phase 1: 基础架构搭建
- Phase 2: 迁移 data_analytics 模块
- Phase 3: FastAPI 端点实现
- Phase 4: 数据库集成
- Phase 5: isA_MCP 集成测试
- Phase 6: 生产部署
🔗 Related Projects
- isA_MCP: MCP 工具层（API 调用端）
- isA_OS: Web & OS 操作云服务
- isA_Model: 模型服务
1 maintainer
Release files for isa-data 1.0.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| isa_data-1.0.6.tar.gz | 19.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| isa_data-1.0.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 40.3 MB
Release files / isa_data-1.0.6.tar.gz
| Download URL | isa_data-1.0.6.tar.gz |
|---|---|
| Size | 19.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3aa31b27ef8692fd59044c00ea1e49268a76ef7767d5292454433202e22bd60c
|
|
BLAKE2b-256 checksum How to use checksums |
636fc6d8d2dec83cf0eae87b28e29689a5abd8170d2473d0476fc4c958b0ec40
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / isa_data-1.0.6-py3-none-any.whl
| Download URL | isa_data-1.0.6-py3-none-any.whl |
|---|---|
| Size | 20.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8005236e78bb31019d692ecff524c2b45a73ec7e899f65f1cf946150ffd143f0
|
|
BLAKE2b-256 checksum How to use checksums |
60f4301ed7132cd3ad678fc6f0a709208ac0c529713f642a8034c97cd7864edf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
