struai 0.0.1__py3-none-any.whl → 0.1.0__py3-none-any.whl

struai-0.1.0.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: struai
+Version: 0.1.0
+Summary: StruAI Drawing Analysis SDK - AI-powered construction drawing analysis
+Project-URL: Homepage, https://struai.com
+Project-URL: Documentation, https://docs.struai.com/python
+Project-URL: Repository, https://github.com/struai/struai-python
+Project-URL: Issues, https://github.com/struai/struai-python/issues
+Author-email: StruAI <support@struai.com>
+License-Expression: MIT
+Keywords: ai,cad,construction drawings,drawing analysis,knowledge graph,pdf,struai,structural engineering
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# StruAI Python SDK
+
+Official Python SDK for the StruAI Drawing Analysis API.
+
+## Installation
+
+```bash
+pip install struai
+```
+
+## Quick Start
+
+```python
+from struai import StruAI
+
+client = StruAI(api_key="sk-xxx")  # or set STRUAI_API_KEY env var
+```
+
+## Tier 1: Raw Detection ($0.02/page)
+
+Fast geometric detection. Returns annotations in ~1-2 seconds.
+
+```python
+# Analyze a PDF page
+result = client.drawings.analyze("structural.pdf", page=4)
+
+print(f"Processed in {result.processing_ms}ms")
+print(f"Page size: {result.dimensions.width}x{result.dimensions.height}")
+
+# Access detected annotations
+for leader in result.annotations.leaders:
+    texts = [t.text for t in leader.texts_inside]
+    print(f"Leader at {leader.arrow_tip}: {', '.join(texts)}")
+
+for tag in result.annotations.section_tags:
+    label = tag.texts_inside[0].text
+    print(f"Section {label}, direction: {tag.direction}")
+
+# Retrieve/delete previous results
+drawing = client.drawings.get("drw_7f8a9b2c")
+client.drawings.delete("drw_7f8a9b2c")
+```
+
+## Tier 2: Graph + Search ($0.15/page)
+
+Full pipeline: detection → LLM enrichment → knowledge graph → semantic search.
+
+```python
+# Create a project
+project = client.projects.create(
+    name="Building A Structural",
+    description="96-page structural drawing set"
+)
+
+# Add sheets (async processing)
+job = project.sheets.add("structural.pdf", page=4)
+result = job.wait(timeout=120)  # Blocks until complete
+print(f"Created {result.entities_created} entities")
+
+# Semantic search
+results = project.search(
+    query="W12x26 beam connections at grid A",
+    limit=10,
+    include_graph_context=True
+)
+
+for hit in results.results:
+    print(f"{hit.entity.label}: {hit.score:.2f}")
+    if hit.graph_context:
+        for rel in hit.graph_context.relationships:
+            print(f"  - {rel.type}: {rel.fact}")
+
+# Natural language query
+answer = project.query("What beams connect to column C3?")
+print(answer.answer)
+print(f"Confidence: {answer.confidence:.0%}")
+
+# Browse entities
+entities = project.entities.list(type="Component", limit=50)
+entity = project.entities.get("ent_abc123")
+```
+
+## Async Support
+
+```python
+from struai import AsyncStruAI
+
+async with AsyncStruAI(api_key="sk-xxx") as client:
+    # Tier 1
+    result = await client.drawings.analyze("structural.pdf", page=4)
+
+    # Tier 2
+    project = await client.projects.create(name="Building A")
+    job = await project.sheets.add("structural.pdf", page=4)
+    result = await job.wait(timeout=120)
+    results = await project.search("W12x26 beam connections")
+```
+
+## Error Handling
+
+```python
+from struai import StruAI, AuthenticationError, RateLimitError, NotFoundError
+
+try:
+    result = client.drawings.analyze("plans.pdf", page=99)
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after}s")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## License
+
+MIT

struai-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+struai/__init__.py,sha256=FsxjwfQOKDXzcnX8TqfWgTOqEbe-rW7zf8hwsqSMq0c,2190
+struai/_base.py,sha256=IPhrlgoqf7RZOh9xy2O6o9qMazEj0-RkI-dXPGzk76U,10795
+struai/_client.py,sha256=AmxmJ0ZSPlYlfqf4WHRaR_PQ1u5m3DCE59pLrf8j-7s,3483
+struai/_exceptions.py,sha256=GK0aVnOdkmcFaO16e0lzj9S2NmnTjQiy5H6nH6yDV24,2021
+struai/_version.py,sha256=PrqPeNLB_vK7o-1a2bBnGr1qOX4JyRedkdthES3yNbw,49
+struai/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+struai/models/__init__.py,sha256=ddFoRRUY32xeHnjI0twEIRtXNh1huyWwggE1sY-y2e4,1144
+struai/models/common.py,sha256=qRehKPxDWPG34_LHhxu7T93Wqz1uRRQzIErQhraYAt4,598
+struai/models/drawings.py,sha256=oTvN0ZID1TdUsR1BkJ-6M87nFbQwsYyePd0xoxKns9I,1634
+struai/models/entities.py,sha256=dlQJqnY1GbVZOy74Rtt7J2JGxtUI7pWyifAO3whmNP0,753
+struai/models/projects.py,sha256=_VYinZrwWCmv3SQy7iZFPBtHcGsZe3XxI1i9SCk0EfY,1654
+struai/models/search.py,sha256=UL3RYsAidS1zdV4lKiwNcHcAIjzyi8dgAQodowjzh58,1324
+struai/resources/__init__.py,sha256=_JT_8OrvVcJ4yHmvZnsqYj4ej8pVg5lKSPKIcgQTCZk,183
+struai/resources/drawings.py,sha256=b3C7CHS-p8CpGBtKl_dvLeUFDJ3g8HjlLBA4II0HsT4,3957
+struai/resources/projects.py,sha256=3HMLbZmhcPQq51uTT3Y21Rx48PDKXF_-ESPDJYBd5tw,19453
+struai-0.1.0.dist-info/METADATA,sha256=hVEKAZoNtYqtqz_c95ouj7GOmY7jKPVvrfn2tYe3iS0,4309
+struai-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+struai-0.1.0.dist-info/RECORD,,

struai-0.0.1.dist-info/METADATA

@@ -1,17 +0,0 @@
-Metadata-Version: 2.4
-Name: struai
-Version: 0.0.1
-Summary: StruAI - AI-powered tools
-Project-URL: Homepage, https://github.com/bhoshaga/struai
-Author-email: bhoshaga <bhoshaga@gmail.com>
-License-Expression: MIT
-Keywords: ai,struai
-Classifier: Development Status :: 1 - Planning
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-
-# struai
-
-Coming soon.

struai-0.0.1.dist-info/RECORD

@@ -1,4 +0,0 @@
-struai/__init__.py,sha256=1VV3qcV5ZM35mMYdb-FwQIXwmF9iTiB7dguaAQdNpEc,35
-struai-0.0.1.dist-info/METADATA,sha256=Bk8MaGENVHMEt6MaRa2hVDcuUTQoc3FUCSMy3zc15as,464
-struai-0.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-struai-0.0.1.dist-info/RECORD,,