steltic 0.1.1__tar.gz

steltic-0.1.1/.env.example

@@ -0,0 +1,20 @@
+# Copy to .env and edit (all optional). The `steltic` command and run_local.sh load it automatically.
+
+# --- data location (default: your OS user-data dir, e.g. %LOCALAPPDATA%\Steltic or ~/.local/share/Steltic) ---
+# DATA_DIR=
+
+# --- sandbox executor ---
+EXECUTOR=auto                 # auto | docker | subprocess   (auto = Docker if available, else subprocess)
+SANDBOX_IMAGE=steel-sandbox:latest
+SANDBOX_TIMEOUT=900           # seconds per run_python
+SANDBOX_MEM=2g
+SANDBOX_CPUS=2
+SANDBOX_PIDS=256
+
+# --- engineering-standards RAG (optional) ---
+# Empty => the agent's search tool returns a 'use your own knowledge' note and it relies on its own
+# cited AISC knowledge. To enable RAG, either point these at YOUR OWN server (see rag_v2/README.md
+# for the expected API), or request access to the hosted Steltic RAG via the contact details at
+# https://stelticai.com.
+RAG_API_URL=
+RAG_API_TOKEN=

steltic-0.1.1/.gitignore

@@ -0,0 +1,29 @@
+# secrets & local config
+.env
+
+# runtime data (designs live in the OS user-data dir by default; this covers DATA_DIR=./data setups)
+data/
+jobs/
+
+# python
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+venv/
+
+# packaging
+dist/
+build/
+*.egg-info/
+
+# editors / OS
+.DS_Store
+
+# working files
+*.zip
+*.bak
+*.bak2
+*.bak3
+*.patch
+SCOPING.md

steltic-0.1.1/DISCLAIMER.md

@@ -0,0 +1,60 @@
+# Steltic — Disclaimer & Limitation of Liability
+
+By downloading, installing, or using **Steltic** (the "Software"), you ("User") agree to all terms
+below. If you do not agree, do not use the Software.
+
+## 1. What Steltic is
+
+Steltic is free, open-source software: an orchestration harness around an AI / large-language-model
+system **that you select and supply** via your own API key. Steltic guides that model through a
+structural-design workflow but **generates no engineering content of its own** — every model,
+calculation, figure, and report (the "Outputs") is produced by your chosen AI. The Software runs
+locally on your machine: your designs stay there, and your prompts go only to the LLM provider you
+configure (and, if you enable one, the RAG server you configure).
+
+## 2. No professional engineering services
+
+The Outputs are **preliminary, informational, and for conceptual/educational purposes only.** Use of
+the Software is **not** the practice of engineering and creates **no** engineer-client or
+professional relationship. No licensed professional has reviewed or sealed the Outputs.
+
+## 3. No warranty — "AS IS"
+
+The Software and all Outputs are provided **"AS IS", with all faults, and WITHOUT WARRANTY OF ANY
+KIND**, express, implied, or statutory, including merchantability, fitness for a particular purpose,
+accuracy, completeness, and non-infringement (see also the MIT [LICENSE](LICENSE)). Because Steltic
+generates no Outputs of its own and does not control the AI model you supply, its authors make no
+representation or guarantee as to the quality, accuracy, or reliability of any Output.
+
+## 4. AI limitations
+
+The Outputs are generated by probabilistic AI systems that can produce errors, omissions, and
+fabricated values that appear authoritative but are wrong, and depend on the third-party model you
+select and supply.
+
+## 5. Independent verification required — NOT FOR CONSTRUCTION
+
+The Outputs **must not** be used for design, construction, fabrication, or permitting, nor relied
+upon for any decision affecting health, safety, or property, **unless and until** independently
+checked and, where applicable, **sealed/stamped by a professional engineer licensed in the relevant
+jurisdiction** who assumes responsibility. You are solely responsible for verifying every input,
+assumption, load, capacity, citation, and result.
+
+## 6. Assumption of risk
+
+You assume **all risk** from using the Software and the Outputs. Any reliance is strictly at your
+own risk.
+
+## 7. Limitation of liability
+
+To the maximum extent permitted by law, the authors, copyright holders, and contributors are **not
+liable** for any claim, damages, or other liability — including any indirect, incidental, special,
+consequential, or punitive damages, or any property damage, personal injury, or death — arising from
+or in connection with the Software or the Outputs, under any theory of liability, even if advised of
+the possibility.
+
+## 8. General
+
+If any provision is unenforceable it is severed and the rest remains in force.
+
+*© 2026 Steltic (stelticai.com).*

steltic-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steltic (stelticai.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

steltic-0.1.1/NOTICE

@@ -0,0 +1,20 @@
+THIRD-PARTY DATA & NOTICES
+==========================
+
+1. AISC-derived data.
+   - steel_engine/aisc_shapes.csv (AISC shape properties) and the AISC 360-22 / 341-22 / 358
+     references in contract/ (AGENT_START.md, README_AGENT.md, AISC360_TOC.md) are derived from
+     AISC publications. AISC specifications and shape data remain the property of the American
+     Institute of Steel Construction. This repository does not reproduce AISC specification text.
+
+2. Three.js.
+   - steel_engine/vendor/three.min.js is Three.js, MIT-licensed (see steel_engine/vendor/THREE_LICENSE).
+
+3. Secrets.
+   - Never commit API keys. All keys (LLM provider, RAG token) are read from the environment or
+     entered at runtime and are excluded by .gitignore (.env). They are NOT written to disk by the app.
+   - If any token was ever pasted into a terminal, file, or chat, treat it as compromised and ROTATE it.
+
+4. Engineering liability.
+   - Outputs are preliminary and must be independently reviewed and, where applicable, sealed/stamped
+     by a professional engineer licensed in the relevant jurisdiction. See DISCLAIMER.md.

steltic-0.1.1/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: steltic
+Version: 0.1.1
+Summary: Free, local AISC 360/341 steel-design agent: your LLM + OpenSees + stamped-style reports
+Project-URL: Homepage, https://stelticai.com
+Author: Steltic
+License-Expression: MIT
+License-File: DISCLAIMER.md
+License-File: LICENSE
+License-File: NOTICE
+Keywords: AISC,agent,llm,opensees,steel-design,structural-engineering
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.110
+Requires-Dist: httpx>=0.27
+Requires-Dist: itsdangerous>=2.1
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: uvicorn[standard]>=0.27
+Provides-Extra: engine
+Requires-Dist: matplotlib; extra == 'engine'
+Requires-Dist: numpy; extra == 'engine'
+Requires-Dist: openseespy; extra == 'engine'
+Requires-Dist: scipy; extra == 'engine'
+Description-Content-Type: text/markdown
+
+# Steltic
+
+A free, open-source AISC 360/341 steel-design agent that runs locally. Paste a design brief and
+watch the agent build an OpenSees model + a stamped-style HTML report + an interactive 3D viewer —
+**bringing your own LLM** (your API base-url + key, held in memory only, never written to disk).
+
+```
+browser ──▶ FastAPI app (localhost) ──▶ your LLM (key in app memory, never stored)
+                 │  parses tool calls
+                 ▼
+           sandbox executor (run_python only) — Docker when available
+                 │
+           steel engine + OpenSees ─▶ report.html + viewer_3d.html
+```
+
+> **Not for construction.** Every output is produced by your own AI model, may be incomplete or
+> incorrect, and must be independently checked and sealed by a licensed professional engineer before
+> any use for design, construction, or permitting. See [DISCLAIMER.md](DISCLAIMER.md).
+
+## Install & run
+
+With [uv](https://docs.astral.sh/uv/) (recommended — no Python setup needed):
+
+```bash
+uv tool install steltic
+steltic                      # starts on http://127.0.0.1:8000 and opens your browser
+```
+
+Or with pipx: `pipx install steltic`. Or from a checkout:
+
+```bash
+git clone <this repo> && cd steltic
+python -m venv .venv && . .venv/bin/activate
+pip install -e .
+./run_local.sh               # http://localhost:8000
+```
+
+First run: open **Settings**, enter your provider's **API base URL** (any OpenAI-compatible
+endpoint — OpenRouter, vLLM, Together, Fireworks, OpenAI, Anthropic…), your **API key**, and a
+**model** id. Then paste a brief (stories, bays & spacings, loads, seismic, system) — or pick one of
+the 36 built-in example briefs — and click **Design building**.
+
+Offline smoke test: set Model to `MOCK` — it drives the whole pipeline (sandbox, engine, OpenSees,
+report) with no LLM.
+
+## Sandbox
+
+The agent's Python only ever executes in a sandbox. `EXECUTOR` (env / `.env`) picks the mode:
+
+| value        | isolation | notes |
+|--------------|-----------|-------|
+| `auto`       | Docker if available, else subprocess | default |
+| `docker`     | container per run: no network, read-only fs, non-root, cpu/mem caps | build once: `./sandbox_image/build.sh` |
+| `subprocess` | none (child process with rlimits) | needs `pip install openseespy numpy scipy matplotlib`; fine for local single-user use |
+
+Steltic binds to 127.0.0.1 and has **no authentication** — don't expose the port. Designs are saved
+under your OS user-data dir (e.g. `%LOCALAPPDATA%\Steltic`, `~/.local/share/Steltic`); override
+with `DATA_DIR`.
+
+## Engineering-standards, OpenSees & design-examples RAG (highly recommended)
+
+The hosted version of Steltic at [stelticai.com](https://stelticai.com) grounds the agent with RAG
+vector databases of AISC 360, 341 and 358 (2022), the AISC Steel Construction Manual Design
+Examples (V16.0, 168 worked examples), an examples database of validated OpenSees models, and two
+databases of the OpenSees documentation. The specifications and design examples ground the LLM in
+the current procedures; the OpenSees databases help it build the model — and when OpenSees throws
+errors, resolve them. Steltic's performance has been validated **with** these databases and will
+likely reduce without them.
+
+For copyright reasons the vector databases of AISC 360, 341 and 358 are **not** open-sourced in
+this project. The rest are freely downloadable from this repo's
+[Releases page](https://github.com/Steltic/steltic/releases) as portable `.jsonl.gz` dumps
+(pre-embedded; see [rag_v2/README.md](rag_v2/README.md) for loading them into your own Qdrant):
+`steel_design_examples` (168 original worked Q&A covering the AISC Design Examples scope),
+`opensees_buildings_3d` (40 validated 3D building models), `opensees_building_templates`, and the
+two OpenSees documentation sets.
+
+Three options:
+
+1. **None (default — not recommended).** Leave `RAG_API_URL` empty — the agent relies on its own
+   cited AISC knowledge. Good models do respectably; grounded runs are better.
+2. **Bring your own server.** Run any server exposing the small API described in
+   [rag_v2/README.md](rag_v2/README.md): load the downloadable OpenSees databases, and build the
+   standards collections from your own licensed copies with the `rag_v2/` chunking + ingestion
+   starter kit. Then put the connection in the environment (or a `.env` next to where you launch):
+   `RAG_API_URL=http://your-server:8080/query` and, if your server enforces one, `RAG_API_TOKEN=...`.
+3. **Hosted Steltic RAG.** The maintained, pre-built full set (specs + design examples + OpenSees).
+   To get access, use the contact details at [stelticai.com](https://stelticai.com), then set the
+   provided `RAG_API_URL` + `RAG_API_TOKEN` in your environment.
+
+## Repo map
+
+`steltic/` FastAPI app + agent loop + sandbox executors · `steel_engine/` OpenSees modelling,
+design pipeline, consistency checks, report + 3D viewer · `contract/` the agent's working contract
+and references · `frontend/` vanilla JS UI · `sandbox_image/` Docker sandbox image ·
+`test_buildings/` 50+ example briefs (steel + CFS) with assessment rubrics · `rag_v2/`, `rag_update/`
+build-your-own-RAG starter kit.
+
+## License
+
+MIT — see [LICENSE](LICENSE), [NOTICE](NOTICE) (third-party data notes) and
+[DISCLAIMER.md](DISCLAIMER.md) (engineering disclaimer; also shown in-app at `/terms`).

steltic-0.1.1/README.md

@@ -0,0 +1,102 @@
+# Steltic
+
+A free, open-source AISC 360/341 steel-design agent that runs locally. Paste a design brief and
+watch the agent build an OpenSees model + a stamped-style HTML report + an interactive 3D viewer —
+**bringing your own LLM** (your API base-url + key, held in memory only, never written to disk).
+
+```
+browser ──▶ FastAPI app (localhost) ──▶ your LLM (key in app memory, never stored)
+                 │  parses tool calls
+                 ▼
+           sandbox executor (run_python only) — Docker when available
+                 │
+           steel engine + OpenSees ─▶ report.html + viewer_3d.html
+```
+
+> **Not for construction.** Every output is produced by your own AI model, may be incomplete or
+> incorrect, and must be independently checked and sealed by a licensed professional engineer before
+> any use for design, construction, or permitting. See [DISCLAIMER.md](DISCLAIMER.md).
+
+## Install & run
+
+With [uv](https://docs.astral.sh/uv/) (recommended — no Python setup needed):
+
+```bash
+uv tool install steltic
+steltic                      # starts on http://127.0.0.1:8000 and opens your browser
+```
+
+Or with pipx: `pipx install steltic`. Or from a checkout:
+
+```bash
+git clone <this repo> && cd steltic
+python -m venv .venv && . .venv/bin/activate
+pip install -e .
+./run_local.sh               # http://localhost:8000
+```
+
+First run: open **Settings**, enter your provider's **API base URL** (any OpenAI-compatible
+endpoint — OpenRouter, vLLM, Together, Fireworks, OpenAI, Anthropic…), your **API key**, and a
+**model** id. Then paste a brief (stories, bays & spacings, loads, seismic, system) — or pick one of
+the 36 built-in example briefs — and click **Design building**.
+
+Offline smoke test: set Model to `MOCK` — it drives the whole pipeline (sandbox, engine, OpenSees,
+report) with no LLM.
+
+## Sandbox
+
+The agent's Python only ever executes in a sandbox. `EXECUTOR` (env / `.env`) picks the mode:
+
+| value        | isolation | notes |
+|--------------|-----------|-------|
+| `auto`       | Docker if available, else subprocess | default |
+| `docker`     | container per run: no network, read-only fs, non-root, cpu/mem caps | build once: `./sandbox_image/build.sh` |
+| `subprocess` | none (child process with rlimits) | needs `pip install openseespy numpy scipy matplotlib`; fine for local single-user use |
+
+Steltic binds to 127.0.0.1 and has **no authentication** — don't expose the port. Designs are saved
+under your OS user-data dir (e.g. `%LOCALAPPDATA%\Steltic`, `~/.local/share/Steltic`); override
+with `DATA_DIR`.
+
+## Engineering-standards, OpenSees & design-examples RAG (highly recommended)
+
+The hosted version of Steltic at [stelticai.com](https://stelticai.com) grounds the agent with RAG
+vector databases of AISC 360, 341 and 358 (2022), the AISC Steel Construction Manual Design
+Examples (V16.0, 168 worked examples), an examples database of validated OpenSees models, and two
+databases of the OpenSees documentation. The specifications and design examples ground the LLM in
+the current procedures; the OpenSees databases help it build the model — and when OpenSees throws
+errors, resolve them. Steltic's performance has been validated **with** these databases and will
+likely reduce without them.
+
+For copyright reasons the vector databases of AISC 360, 341 and 358 are **not** open-sourced in
+this project. The rest are freely downloadable from this repo's
+[Releases page](https://github.com/Steltic/steltic/releases) as portable `.jsonl.gz` dumps
+(pre-embedded; see [rag_v2/README.md](rag_v2/README.md) for loading them into your own Qdrant):
+`steel_design_examples` (168 original worked Q&A covering the AISC Design Examples scope),
+`opensees_buildings_3d` (40 validated 3D building models), `opensees_building_templates`, and the
+two OpenSees documentation sets.
+
+Three options:
+
+1. **None (default — not recommended).** Leave `RAG_API_URL` empty — the agent relies on its own
+   cited AISC knowledge. Good models do respectably; grounded runs are better.
+2. **Bring your own server.** Run any server exposing the small API described in
+   [rag_v2/README.md](rag_v2/README.md): load the downloadable OpenSees databases, and build the
+   standards collections from your own licensed copies with the `rag_v2/` chunking + ingestion
+   starter kit. Then put the connection in the environment (or a `.env` next to where you launch):
+   `RAG_API_URL=http://your-server:8080/query` and, if your server enforces one, `RAG_API_TOKEN=...`.
+3. **Hosted Steltic RAG.** The maintained, pre-built full set (specs + design examples + OpenSees).
+   To get access, use the contact details at [stelticai.com](https://stelticai.com), then set the
+   provided `RAG_API_URL` + `RAG_API_TOKEN` in your environment.
+
+## Repo map
+
+`steltic/` FastAPI app + agent loop + sandbox executors · `steel_engine/` OpenSees modelling,
+design pipeline, consistency checks, report + 3D viewer · `contract/` the agent's working contract
+and references · `frontend/` vanilla JS UI · `sandbox_image/` Docker sandbox image ·
+`test_buildings/` 50+ example briefs (steel + CFS) with assessment rubrics · `rag_v2/`, `rag_update/`
+build-your-own-RAG starter kit.
+
+## License
+
+MIT — see [LICENSE](LICENSE), [NOTICE](NOTICE) (third-party data notes) and
+[DISCLAIMER.md](DISCLAIMER.md) (engineering disclaimer; also shown in-app at `/terms`).