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

struai-0.2.0.dist-info/METADATA

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: struai
+Version: 0.2.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
+
+# Optional: override base URL (http://localhost:8000 or http://localhost:8000/v1)
+client = StruAI(api_key="sk-xxx", base_url="http://localhost:8000")
+```
+
+## 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.2.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+struai/__init__.py,sha256=SmHeLcTTzSUNIYXmiDmE2_LRxZl8fUYQwhHHCvJwoGY,2274
+struai/_base.py,sha256=JiAxWI1PMmIFVr9v_hBABra8m2fRkEvBp7d2Vc-5IAk,11208
+struai/_client.py,sha256=jTRb8UbAwgFyfGoSHfO5_3QMgiHbew-s7n3bbabIZ18,3541
+struai/_exceptions.py,sha256=GK0aVnOdkmcFaO16e0lzj9S2NmnTjQiy5H6nH6yDV24,2021
+struai/_version.py,sha256=b49QzOi1rklaJqTPnxwmLbtWwDKXokP9JbtqeJykzp8,49
+struai/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+struai/models/__init__.py,sha256=qA_e6ZGG7Uhq9aLX2LeXlnUuV8VE6ur3OCFOPcj1oco,1220
+struai/models/common.py,sha256=qRehKPxDWPG34_LHhxu7T93Wqz1uRRQzIErQhraYAt4,598
+struai/models/drawings.py,sha256=oTvN0ZID1TdUsR1BkJ-6M87nFbQwsYyePd0xoxKns9I,1634
+struai/models/entities.py,sha256=4MHfhCn4g0n6d-6asASklbcmbJcIPg91rMBc5f56Zm8,1348
+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=_KRHO6ByBN_W-STlaAhVljLt9F3Yh9xzV5Piahc50FQ,19501
+struai-0.2.0.dist-info/METADATA,sha256=aILI4YDk7L0ZjyjOuA_8mmG0gAXSDV6DO5WEKz0S2iU,4460
+struai-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+struai-0.2.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,,