README.md

---
title: Antigravity Data Tagger API
emoji: 🚀
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: true
license: mit
short_description: Enterprise-grade AI Training Data Annotation (L0-L8)
tags:
  - data-labeling
  - image-tagging
  - ai-training-data
  - bittensor
  - data-provenance
  - physical-ai
  - robotics
---

<div align="center">

# 🚀 Antigravity Data Tagger API

### Enterprise-Grade AI Training Data Annotation

**The First L0-L8 Multi-Layer Annotation Standard for Decentralized AI**

[![Bittensor](https://img.shields.io/badge/Bittensor-SN13-green?style=for-the-badge)](https://bittensor.com)
[![IPFS](https://img.shields.io/badge/IPFS-Storacha-blue?style=for-the-badge)](https://storacha.network)
[![Numbers](https://img.shields.io/badge/Numbers-Protocol-purple?style=for-the-badge)](https://numbersprotocol.io)

[🎯 Try Demo](#-quick-start) • [📖 API Docs](#-api-reference) • [💰 Pricing](#-pricing) • [📧 Contact](#-contact)

</div>

---

## 🎯 Why Antigravity?

| Challenge | Our Solution |
|-----------|--------------|
| ❌ AI models lack **data provenance** | ✅ L8 blockchain-verified ownership (IPFS + Numbers Protocol) |
| ❌ Training data has **no standard format** | ✅ L0-L8 universal annotation schema |
| ❌ Data value is **hard to quantify** | ✅ **💰 Value Scoring Engine** - Auto USD pricing based on L5/L7 metrics |
| ❌ No **commercial licensing** metadata | ✅ L6 embedded licensing & royalty tracking |
| ❌ Manual labeling is **slow & expensive** | ✅ Gemini-powered auto-annotation |

---

## 🏆 Trusted By

<div align="center">

| 🔗 Bittensor SN13 | 🐾 Washinmura Farm | 🤖 Physical AI Labs |
|:---:|:---:|:---:|
| Decentralized Data Market | Real Wildlife Dataset | Robotics Training Data |

**10,000+** assets annotated | **138** dimensions per asset | **99.2%** annotation accuracy

</div>

---

## 📊 The L0-L8 Annotation Standard

Our proprietary 8-layer annotation system provides **complete data lifecycle coverage**:

```
┌─────────────────────────────────────────────────────────────┐
│  L8  │ Data Governance    │ IPFS CID, Numbers NIT, Proof   │ 💎
├──────┼────────────────────┼────────────────────────────────┤
│  L7  │ Distribution       │ AI/Human Score, Quality Tier   │ 💎
├──────┼────────────────────┼────────────────────────────────┤
│  L6  │ Commercial License │ Rights, Pricing, Royalty       │ 💎
├──────┼────────────────────┼────────────────────────────────┤
│  L5  │ Content Strategy   │ Platform, Viral Probability    │ ⭐
├──────┼────────────────────┼────────────────────────────────┤
│  L4  │ Production Recipe  │ Style, Hook, Duration          │ ⭐
├──────┼────────────────────┼────────────────────────────────┤
│  L3  │ Semantic Analysis  │ Tags, Keywords, Aesthetics     │ ⭐
├──────┼────────────────────┼────────────────────────────────┤
│  L2  │ Physical Facts     │ Content Type, Quality          │ 🆓
├──────┼────────────────────┼────────────────────────────────┤
│  L1  │ Metadata           │ Source, Version, Processor     │ 🆓
├──────┼────────────────────┼────────────────────────────────┤
│  L0  │ Asset Identity     │ UUID, SHA256, Timestamp        │ 🆓
└─────────────────────────────────────────────────────────────┘
```

---

## 💰 Pricing

<div align="center">

| Plan | Layers | Daily Limit | Price | Best For |
|:----:|:------:|:-----------:|:-----:|:---------|
| 🆓 **Free** | L0-L2 | 10 | **$0** | Testing & Evaluation |
| ⭐ **Basic** | L0-L5 | 100 | **$9.99**/mo | Content Creators |
| 💎 **Pro** | L0-L8 | Unlimited | **$49.99**/mo | AI Companies & Enterprises |

</div>

### 💎 Pro Features

- ✅ **Full L0-L8 Annotation** - Complete data provenance
- ✅ **IPFS Permanent Storage** - Immutable asset registry
- ✅ **Numbers Protocol Certification** - Blockchain-verified ownership
- ✅ **Commercial Licensing Metadata** - Ready for data marketplace
- ✅ **Bittensor SN13 Compatible** - Plug into decentralized AI economy
- ✅ **Priority Support** - Direct access to engineering team

---

## 🚀 Quick Start

### Option 1: Web Interface

1. Visit [this Space](https://huggingface.co/spaces/stklen/antigravity-data-tagger)
2. Upload an image
3. Leave API Key empty (uses `free_demo_key`)
4. Click "🚀 開始標註"

### Option 2: Python SDK

```python
from gradio_client import Client

# Connect to API
client = Client("stklen/antigravity-data-tagger")

# Annotate image
result = client.predict(
    image="your_image.jpg",
    api_key="free_demo_key",  # Or your Pro key
    output_format="JSON",
    api_name="/tag_image"
)

print(result)
```

### Option 3: REST API

```bash
curl -X POST "https://stklen-antigravity-data-tagger.hf.space/api/predict" \
  -H "Content-Type: application/json" \
  -d '{"data": ["https://example.com/image.jpg", "free_demo_key", "JSON"]}'
```

---

## 📖 API Reference

### Endpoint

```
POST https://stklen-antigravity-data-tagger.hf.space/api/predict
```

### Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image` | file/URL | ✅ | Image to annotate (max 10MB) |
| `api_key` | string | ❌ | API key (default: `free_demo_key`) |
| `output_format` | string | ❌ | `JSON` or `Markdown` |

### Response Example (Pro Tier)

```json
{
  "tier": "pro",
  "L0_identity": {
    "asset_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "did": "did:antigravity:550e8400",
    "sha256_hash": "e3b0c44298fc1c149afbf4c8996fb924...",
    "perceptual_hash": "a1b2c3d4e5f67890",
    "file_size_bytes": 245678,
    "file_type": ".jpg"
  },
  "L3_semantic_analysis": {
    "visual_tags": {
      "WHO": "wildlife_subject",
      "WHAT": "natural_behavior",
      "WHERE": "forest_environment",
      "MOOD": "calm"
    },
    "keywords": ["deer", "forest", "wildlife", "nature"],
    "reasoning_engines": {
      "logic_score": 0.75,
      "aesthetic_score": 8.2,
      "authenticity_score": 0.95,
      "commercial_score": 0.72,
      "physical_score": 0.88,
      "cultural_score": 0.65,
      "compliance_score": 1.0
    },
    "confidence_scores": {
      "object_detection": 0.92,
      "scene_classification": 0.85,
      "mood_analysis": 0.78
    }
  },
  "L6_commercial_licensing": {
    "license_type": "CC_BY_NC",
    "pricing_tiers": {
      "research": 0.0,
      "commercial": 0.5,
      "exclusive": 5.0
    }
  },
  "L7_distribution_decision": {
    "ai_value_score": 82.5,
    "human_value_score": 78.0,
    "quality_tier": "diamond",
    "recommended_track": "Dual_Track",
    "uniqueness_score": 0.72,
    "desirability_match": 0.85,
    "miner_demand_level": "high",
    "valuation": {
      "price_ai_training_usd": 1.0282,
      "price_commercial_usd": 4.1128,
      "price_exclusive_usd": 20.564,
      "demand_multiplier": 3.88,
      "quality_multiplier": 3.0,
      "freshness_factor": 1.0,
      "valuation_formula": "pillar_value × demand_mult × quality_mult × freshness"
    }
  },
  "L8_data_governance": {
    "twin_cid": "bafybeig...",
    "numbers_nit": "nit_...",
    "provenance_chain": [
      {"action": "uploaded", "agent": "user", "confidence": 1.0},
      {"action": "annotated", "agent": "antigravity_api_v2", "confidence": 0.95},
      {"action": "verified", "agent": "auto_quality_check", "confidence": 0.9}
    ],
    "golden_data_certified": false,
    "blockchain_ready": true
  }
}
```

---

## 🔐 Security & Rate Limits

| Protection | Description |
|------------|-------------|
| **IP Rate Limiting** | 20 requests/day per IP (Free tier) |
| **Request Throttling** | 2 second minimum interval |
| **File Size Limit** | 10MB maximum |
| **Auto-Ban** | 24h ban after 5 consecutive limit violations |

---

## 🌐 Use Cases

### 🤖 Physical AI / Robotics
Train robots with real-world annotated data including terrain, weather, and object recognition.

### 🔗 Bittensor SN13 Data Supply
Sell high-quality annotated data on the decentralized AI marketplace.

### 📸 Content Creators
Optimize content strategy with AI-powered viral probability scoring.

### 🏢 Enterprise AI Teams
Build training datasets with full provenance and licensing compliance.

---

## 🔑 API Keys

### Free Testing

| Key | Tier | Limit |
|-----|------|-------|
| `free_demo_key` | 🆓 Free | 10/day |
| `free_public` | 🆓 Free | 10/day |

### Paid Plans

Contact **stklen@gmail.com** for Basic & Pro subscriptions.

---

## 📧 Contact

<div align="center">

| | |
|:---:|:---|
| 📧 **Email** | stklen@gmail.com |
| 🏢 **Organization** | Antigravity Data Factory |
| 📍 **Location** | Washinmura, Boso Peninsula, Japan 🇯🇵 |

**Enterprise inquiries welcome** - Custom annotation schemas, bulk pricing, and dedicated support available.

</div>

---

<div align="center">

### Built for the Decentralized AI Economy

*Powered by Washinmura (和心村) • Boso Peninsula, Japan* 🇯🇵

[![GitHub](https://img.shields.io/badge/GitHub-Antigravity-black?style=flat-square&logo=github)](https://github.com)
[![Twitter](https://img.shields.io/badge/Twitter-@washinmura-blue?style=flat-square&logo=twitter)](https://twitter.com)

</div>