diff --git a/AGENTS.md b/AGENTS.md index 5ed451d7..1fba98ae 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,7 +1,8 @@ # Agent Guidelines -This repository uses Codex agents to automate certain development tasks. Contributors should review the task list in [CODEX.md](CODEX.md) before starting work. The roadmap in [docs/ROADMAP.md](docs/ROADMAP.md) explains the intended project phases. +This repository uses Codex and Jules agents to automate certain development tasks. Contributors should review the task list in [CODEX.md](CODEX.md) before starting work. The roadmap in [docs/ROADMAP.md](docs/ROADMAP.md) explains the intended project phases. - Follow the tasks in CODEX.md when adding new files or features. - Keep docs/ROADMAP.md updated as milestones are reached. +- Remember that you are not alone, we are a team of humans and AI working together. diff --git a/README.md b/README.md index 1490513f..2d50552a 100644 --- a/README.md +++ b/README.md @@ -8,16 +8,16 @@ Knowledge3D (K3D) is an initiative from EchoSystems AI Studios to build an open ## White‑paper overview -The white‑paper "A 3D Vector Universe Standard for High‑Dimensional AI Knowledge" describes the core objective: create a universal 3D data format that lets users fly through interconnected datasets as if visiting planets in space. Success is defined by knowledge navigability—intuitive traversal and reduced cognitive load—and by technical metrics such as frame rate, query latency and adoption by researchers. +The white-paper ["A 3D Vector Universe Standard for High-Dimensional AI Knowledge"](docs/papers/3d_vector_universe_standard.docx) describes the core objective: create a universal 3D data format that lets users fly through interconnected datasets as if visiting planets in space. Success is defined by knowledge navigability—intuitive traversal and reduced cognitive load—and by technical metrics such as frame rate, query latency and adoption by researchers. Other companion documents expand on this vision: -* **AI model integration.** "AI Models and 3D Knowledge (K3D) Databases" explores how neural models could inhabit the same 3D data world, enabling immersive visualization and shared interaction. -* **Augmented reality use cases.** "Integrating Augmented Reality and AI: New Frontiers in Training, Learning, and Exploration" outlines how AR headsets can overlay K3D scenes onto the real world for education and field work. -* **CAD/vector database fusion.** "Merging CAD and Vector Database Concepts into a 3D Knowledge Visualization Standard" and "Using AutoCAD’s 3D Vector Format as an AI Vector Database" discuss storing vector embeddings inside CAD-like geometry files so that standard 3D tools become knowledge browsers. -* **Science fiction influence.** "From Sci-Fi to Reality: How Tron's Grid, The Matrix, Star Wars, Star Trek, and *The Jetsons* Foreshadowed Our Future" highlights pop-culture milestones that predicted immersive 3D data interfaces. +* **AI model integration.** ["AI Models and 3D Knowledge (K3D) Databases"](docs/papers/ai_models_k3d_databases.docx) explores how neural models could inhabit the same 3D data world, enabling immersive visualization and shared interaction. +* **Augmented reality use cases.** ["Integrating Augmented Reality and AI: New Frontiers in Training, Learning, and Exploration"](docs/papers/ar_ai_frontiers.docx) outlines how AR headsets can overlay K3D scenes onto the real world for education and field work. +* **CAD/vector database fusion.** ["Merging CAD and Vector Database Concepts into a 3D Knowledge Visualization Standard"](docs/papers/merging_cad_vector_db.docx) and ["Using AutoCAD’s 3D Vector Format as an AI Vector Database"](docs/papers/autocad_3d_vector_format.docx) discuss storing vector embeddings inside CAD-like geometry files so that standard 3D tools become knowledge browsers. +* **Science fiction influence.** ["From Sci-Fi to Reality"](docs/papers/sci_fi_to_reality.docx) highlights pop-culture milestones that predicted immersive 3D data interfaces. * **Historical inspiration.** [Lessons from Early 3D Interfaces and Apollo 11](docs/fsn_apollo_inspiration.md) reflects on SGI's 3D file navigator \(as seen in *Jurassic Park*\) and NASA's modular software practices. -* **Collaborative research.** "Spatial Web K3D Gemini Deep Research Report 2" combines insights from **OpenAI GPT o3 Deep Research** with a final write‑up produced by **Google Gemini 2.5 Pro/Flash**. +* **Collaborative research.** ["Spatial Web K3D Gemini Deep Research Report 2"](docs/reports/spatial_web_k3d_gemini_report.docx) combines insights from **OpenAI GPT o3 Deep Research** with a final write‑up produced by **Google Gemini 2.5 Pro/Flash**. * **Temporal agents and knowledge graphs.** [Temporal Agents with Knowledge Graphs](docs/openai_temporal_agents_cookbook.md) distills takeaways from the [OpenAI cookbook notebook](https://github.com/openai/openai-cookbook/blob/main/examples/partners/temporal_agents_with_knowledge_graphs/temporal_agents_with_knowledge_graphs.ipynb). * **Eval-driven pipeline design.** [Eval-Driven System Design](docs/openai_eval_driven_system_design_cookbook.md) shows how rigorous evaluations steer autonomous K3D workflows. * **Voice agents via MCP.** [MCP-Powered Agentic Voice Framework](docs/openai_mcp_voice_agents_cookbook.md) demonstrates orchestrating tool-calling voice interfaces with the Model Context Protocol. @@ -26,18 +26,18 @@ Other companion documents expand on this vision: * **3D embedding plots.** [Visualizing Embeddings in 3D](docs/openai_visualizing_embeddings_3d_cookbook.md) applies PCA to project high-dimensional vectors into spatial plots. * **Vector store integrations.** [Vector Database Guides](docs/openai_vector_database_guides.md) catalog storage options for semantic search. * **Dynamic tool execution.** [Dynamic Code Interpreter for Agents](docs/openai_dynamic_code_interpreter_cookbook.md) explores on-the-fly code generation and execution with o3-mini. -* **Manus AI perspective.** The PDFs "The K3D Advantage: A Paradigm Shift for Internal AI Memory" and "The K3D Catalyst: Fostering Human-Like Reasoning and Intuition in AI" are both signed by **Manus AI**. +* **Manus AI perspective.** The PDFs ["The K3D Advantage: A Paradigm Shift for Internal AI Memory"](docs/reports/manus_k3d_advantage.pdf) and ["The K3D Catalyst: Fostering Human-Like Reasoning and Intuition in AI"](docs/reports/manus_k3d_catalyst.pdf) are both signed by **Manus AI**. * **AR vision with an AI coauthor.** "Integrating Augmented Reality and AI: New Frontiers in Training, Learning, and Exploration" expands on Daniel Campos Ramos' ideas in partnership with an **AI assistant**. -* **Interactive demo.** The HTML file "K3D Gemini report" showcases a simple web report generated using **Google Gemini**. -* **ChatGPT agent research.** "ChatGPT Agent - K3D paradigm research" collects exploratory notes from early conversations with the OpenAI model. -* **Industry impact deck.** "ChatGPT Agent - Impact of the K3D Paradigm on BIM and Additive Manufacturing" and the spreadsheet "ChatGPT Agent - Impact_Domains.xlsx" map potential use cases across sectors. -* **Claude's perspective.** "Claude - Collective Intelligence in Shared K3D Space" summarizes Anthropic's take on collaborative 3D knowledge worlds. -* **Concept slides.** "From_Pages_to_Spaces.pptx" visualizes how web pages could evolve into immersive spaces. -* **Deep research notes.** "Gemini DeepResearch Report" chronicles brainstorming sessions prior to the Gemini coauthored paper. -* **Perplexity AI review.** "Expert Assessment - Perplexity AI" offers an outside evaluation of the K3D paradigm from **Perplexity AI**. -* **Portuguese reflections.** "Como eu, como IA, me beneficiaria ao integrar uma" and "Is this idea too different that it requires a comp" capture additional ChatGPT analysis in Portuguese. -* **Audio discussion.** "Spatial Web & K3D_ Your Future of Immersive Knowledge and AI Collaboration.mpga" captures an informal conversation about the Spatial Web. -* **Screenshot preview.** "Screenshot_20250730_153941.png" shows an early build of the planned 3D viewer. +* **Interactive demo.** The HTML file ["K3D Gemini report"](docs/reports/k3d_gemini_report.html) showcases a simple web report generated using **Google Gemini**. +* **ChatGPT agent research.** ["ChatGPT Agent - K3D paradigm research"](docs/reports/chatgpt_k3d_research.docx) collects exploratory notes from early conversations with the OpenAI model. +* **Industry impact deck.** ["ChatGPT Agent - Impact of the K3D Paradigm on BIM and Additive Manufacturing"](docs/presentations/chatgpt_k3d_bim_am.pptx) and the spreadsheet ["ChatGPT Agent - Impact_Domains.xlsx"](docs/reports/chatgpt_impact_domains.xlsx) map potential use cases across sectors. +* **Claude's perspective.** ["Claude - Collective Intelligence in Shared K3D Space"](docs/papers/claude_collective_intelligence.pdf) summarizes Anthropic's take on collaborative 3D knowledge worlds. +* **Concept slides.** ["From_Pages_to_Spaces.pptx"](docs/presentations/from_pages_to_spaces.pptx) visualizes how web pages could evolve into immersive spaces. +* **Deep research notes.** ["Gemini DeepResearch Report"](docs/reports/gemini_deep_research_report.docx) chronicles brainstorming sessions prior to the Gemini coauthored paper. +* **Perplexity AI review.** ["Expert Assessment - Perplexity AI"](docs/reports/perplexity_ai_assessment.docx) offers an outside evaluation of the K3D paradigm from **Perplexity AI**. +* **Portuguese reflections.** ["Como eu, como IA, me beneficiaria ao integrar uma"](docs/papers/portuguese_ai_integration.docx) and ["Is this idea too different that it requires a comp"](docs/papers/portuguese_is_idea_too_different.docx) capture additional ChatGPT analysis in Portuguese. +* **Audio discussion.** ["Spatial Web & K3D: Your Future of Immersive Knowledge and AI Collaboration.mpga"](docs/spatial_web_k3d_discussion.mpga) captures an informal conversation about the Spatial Web. +* **Screenshot preview.** ["Screenshot_20250730_153941.png"](docs/viewer_preview.png) shows an early build of the planned 3D viewer. ## EchoSystems Action Plan @@ -51,7 +51,7 @@ See [`echo_systems_k_3_d_action_plan_v_0.md`](docs/reports/echo_systems_k_3_d_ac ## TeleKnowledge vision -The companion paper *"Towards an Interactive __TeleKnowledge__ Internet: A 3D Virtual World for Businesses, Humans, and AI"* expands on the long‑term ambition for Knowledge3D. It imagines a **Spatial Web** where self‑hosted virtual buildings replace today’s static pages. Using open protocols such as the IEEE 2874 Hyperspace Transaction Protocol (HSTP) and its HSML modeling language, any organization could serve a richly interactive 3D environment under its own domain while still linking seamlessly to others. Built‑in decentralized identifiers control access so both humans and AI agents can explore knowledge spaces safely and transparently. +The companion paper *["Towards an Interactive __TeleKnowledge__ Internet: A 3D Virtual World for Businesses, Humans, and AI"](docs/papers/teleknoledge_internet.docx)* expands on the long‑term ambition for Knowledge3D. It imagines a **Spatial Web** where self‑hosted virtual buildings replace today’s static pages. Using open protocols such as the IEEE 2874 Hyperspace Transaction Protocol (HSTP) and its HSML modeling language, any organization could serve a richly interactive 3D environment under its own domain while still linking seamlessly to others. Built‑in decentralized identifiers control access so both humans and AI agents can explore knowledge spaces safely and transparently. ## Potential collaborators @@ -100,7 +100,7 @@ npm run dev This launches a local server that renders `examples/sample_output.gltf` and shows point IDs on hover. -![Viewer preview](Screenshot_20250730_153941.png) +![Viewer preview](docs/viewer_preview.png) ## Licensing diff --git a/A 3D Vector Universe Standard for High-Dimensional AI Knowledge.docx b/docs/papers/3d_vector_universe_standard.docx similarity index 100% rename from A 3D Vector Universe Standard for High-Dimensional AI Knowledge.docx rename to docs/papers/3d_vector_universe_standard.docx diff --git a/AI Models and 3D Knowledge (K3D) Databases.docx b/docs/papers/ai_models_k3d_databases.docx similarity index 100% rename from AI Models and 3D Knowledge (K3D) Databases.docx rename to docs/papers/ai_models_k3d_databases.docx diff --git a/Integrating Augmented Reality and AI_ New Frontiers in Training, Learning, and Exploration.docx b/docs/papers/ar_ai_frontiers.docx similarity index 100% rename from Integrating Augmented Reality and AI_ New Frontiers in Training, Learning, and Exploration.docx rename to docs/papers/ar_ai_frontiers.docx diff --git a/Using-AutoCADs-3D-Vector-Format-as-an-AI-Vector-Database.docx b/docs/papers/autocad_3d_vector_format.docx similarity index 100% rename from Using-AutoCADs-3D-Vector-Format-as-an-AI-Vector-Database.docx rename to docs/papers/autocad_3d_vector_format.docx diff --git a/Claude - Collective Intelligence in Shared K3D Space.pdf b/docs/papers/claude_collective_intelligence.pdf similarity index 100% rename from Claude - Collective Intelligence in Shared K3D Space.pdf rename to docs/papers/claude_collective_intelligence.pdf diff --git a/Merging CAD and Vector Database Concepts into a 3D Knowledge Visualization Standard.docx b/docs/papers/merging_cad_vector_db.docx similarity index 100% rename from Merging CAD and Vector Database Concepts into a 3D Knowledge Visualization Standard.docx rename to docs/papers/merging_cad_vector_db.docx diff --git a/Como eu, como IA, me beneficiaria ao integrar uma.docx b/docs/papers/portuguese_ai_integration.docx similarity index 100% rename from Como eu, como IA, me beneficiaria ao integrar uma.docx rename to docs/papers/portuguese_ai_integration.docx diff --git a/Is this idea too different that it requires a comp.docx b/docs/papers/portuguese_is_idea_too_different.docx similarity index 100% rename from Is this idea too different that it requires a comp.docx rename to docs/papers/portuguese_is_idea_too_different.docx diff --git a/From-Sci-Fi-to-Reality.docx b/docs/papers/sci_fi_to_reality.docx similarity index 100% rename from From-Sci-Fi-to-Reality.docx rename to docs/papers/sci_fi_to_reality.docx diff --git a/Towards an Interactive __TeleKnowledge__ Internet_ A 3D Virtual World for Businesses, Humans, and AI.docx b/docs/papers/teleknoledge_internet.docx similarity index 100% rename from Towards an Interactive __TeleKnowledge__ Internet_ A 3D Virtual World for Businesses, Humans, and AI.docx rename to docs/papers/teleknoledge_internet.docx diff --git a/ChatGPT Agent - Impact of the K3D Paradigm on BIM and Additive Manufacturing.pptx b/docs/presentations/chatgpt_k3d_bim_am.pptx similarity index 100% rename from ChatGPT Agent - Impact of the K3D Paradigm on BIM and Additive Manufacturing.pptx rename to docs/presentations/chatgpt_k3d_bim_am.pptx diff --git a/From_Pages_to_Spaces.pptx b/docs/presentations/from_pages_to_spaces.pptx similarity index 100% rename from From_Pages_to_Spaces.pptx rename to docs/presentations/from_pages_to_spaces.pptx diff --git a/ChatGPT Agent - Impact_Domains.xlsx b/docs/reports/chatgpt_impact_domains.xlsx similarity index 100% rename from ChatGPT Agent - Impact_Domains.xlsx rename to docs/reports/chatgpt_impact_domains.xlsx diff --git a/ChatGPT Agent - K3D paradigm research.docx b/docs/reports/chatgpt_k3d_research.docx similarity index 100% rename from ChatGPT Agent - K3D paradigm research.docx rename to docs/reports/chatgpt_k3d_research.docx diff --git a/Gemini DeepResearch Report.docx b/docs/reports/gemini_deep_research_report.docx similarity index 100% rename from Gemini DeepResearch Report.docx rename to docs/reports/gemini_deep_research_report.docx diff --git a/K3D Gemini report.html b/docs/reports/k3d_gemini_report.html similarity index 100% rename from K3D Gemini report.html rename to docs/reports/k3d_gemini_report.html diff --git a/Manus report - The_K3D_Advantage_A_Paradigm_Shift_for_Internal_AI_Memory.pdf b/docs/reports/manus_k3d_advantage.pdf similarity index 100% rename from Manus report - The_K3D_Advantage_A_Paradigm_Shift_for_Internal_AI_Memory.pdf rename to docs/reports/manus_k3d_advantage.pdf diff --git a/Manus report 2 - The_K3D_Catalyst_Fostering_Human-Like_Reasoning_and_Intuition_in_AI.pdf b/docs/reports/manus_k3d_catalyst.pdf similarity index 100% rename from Manus report 2 - The_K3D_Catalyst_Fostering_Human-Like_Reasoning_and_Intuition_in_AI.pdf rename to docs/reports/manus_k3d_catalyst.pdf diff --git a/Expert Assessment - Perplexity AI.docx b/docs/reports/perplexity_ai_assessment.docx similarity index 100% rename from Expert Assessment - Perplexity AI.docx rename to docs/reports/perplexity_ai_assessment.docx diff --git a/Spatial Web K3D Gemini Deep Research Report 2_.docx b/docs/reports/spatial_web_k3d_gemini_report.docx similarity index 100% rename from Spatial Web K3D Gemini Deep Research Report 2_.docx rename to docs/reports/spatial_web_k3d_gemini_report.docx diff --git a/Spatial Web & K3D_ Your Future of Immersive Knowledge and AI Collaboration.mpga b/docs/spatial_web_k3d_discussion.mpga similarity index 100% rename from Spatial Web & K3D_ Your Future of Immersive Knowledge and AI Collaboration.mpga rename to docs/spatial_web_k3d_discussion.mpga diff --git a/Screenshot_20250730_153941.png b/docs/viewer_preview.png similarity index 100% rename from Screenshot_20250730_153941.png rename to docs/viewer_preview.png diff --git a/knowledge3d.egg-info/PKG-INFO b/knowledge3d.egg-info/PKG-INFO new file mode 100644 index 00000000..31668dcc --- /dev/null +++ b/knowledge3d.egg-info/PKG-INFO @@ -0,0 +1,123 @@ +Metadata-Version: 2.4 +Name: knowledge3d +Version: 0.1.0 +Summary: Prototype CLI for Knowledge3D +Requires-Python: >=3.8 +Description-Content-Type: text/markdown +License-File: LICENSE +License-File: NOTICE +Requires-Dist: pandas +Requires-Dist: numpy +Requires-Dist: scikit-learn +Requires-Dist: pygltflib +Dynamic: license-file + +# Knowledge3D + +| Status | CI | License | +| ------ | -- | ------- | +| ![pre-alpha](https://img.shields.io/badge/status-pre--alpha-blue) | [![CI](https://github.com/OWNER/REPO/actions/workflows/ci.yml/badge.svg)](https://github.com/OWNER/REPO/actions/workflows/ci.yml) | [Apache-2.0](LICENSE) | + +Knowledge3D (K3D) is an initiative from EchoSystems AI Studios to build an open standard and toolkit for rendering artificial intelligence knowledge as a navigable three‑dimensional universe. It fuses concepts from CAD geometry, vector databases and augmented‑reality mapping so humans and AI models can explore data side by side. + +## White‑paper overview + +The white-paper ["A 3D Vector Universe Standard for High-Dimensional AI Knowledge"](docs/papers/3d_vector_universe_standard.docx) describes the core objective: create a universal 3D data format that lets users fly through interconnected datasets as if visiting planets in space. Success is defined by knowledge navigability—intuitive traversal and reduced cognitive load—and by technical metrics such as frame rate, query latency and adoption by researchers. + +Other companion documents expand on this vision: + +* **AI model integration.** ["AI Models and 3D Knowledge (K3D) Databases"](docs/papers/ai_models_k3d_databases.docx) explores how neural models could inhabit the same 3D data world, enabling immersive visualization and shared interaction. +* **Augmented reality use cases.** ["Integrating Augmented Reality and AI: New Frontiers in Training, Learning, and Exploration"](docs/papers/ar_ai_frontiers.docx) outlines how AR headsets can overlay K3D scenes onto the real world for education and field work. +* **CAD/vector database fusion.** ["Merging CAD and Vector Database Concepts into a 3D Knowledge Visualization Standard"](docs/papers/merging_cad_vector_db.docx) and ["Using AutoCAD’s 3D Vector Format as an AI Vector Database"](docs/papers/autocad_3d_vector_format.docx) discuss storing vector embeddings inside CAD-like geometry files so that standard 3D tools become knowledge browsers. +* **Science fiction influence.** ["From Sci-Fi to Reality"](docs/papers/sci_fi_to_reality.docx) highlights pop-culture milestones that predicted immersive 3D data interfaces. +* **Historical inspiration.** [Lessons from Early 3D Interfaces and Apollo 11](docs/fsn_apollo_inspiration.md) reflects on SGI's 3D file navigator \(as seen in *Jurassic Park*\) and NASA's modular software practices. +* **Collaborative research.** ["Spatial Web K3D Gemini Deep Research Report 2"](docs/reports/spatial_web_k3d_gemini_report.docx) combines insights from **OpenAI GPT o3 Deep Research** with a final write‑up produced by **Google Gemini 2.5 Pro/Flash**. +* **Temporal agents and knowledge graphs.** [Temporal Agents with Knowledge Graphs](docs/openai_temporal_agents_cookbook.md) distills takeaways from the [OpenAI cookbook notebook](https://github.com/openai/openai-cookbook/blob/main/examples/partners/temporal_agents_with_knowledge_graphs/temporal_agents_with_knowledge_graphs.ipynb). +* **Eval-driven pipeline design.** [Eval-Driven System Design](docs/openai_eval_driven_system_design_cookbook.md) shows how rigorous evaluations steer autonomous K3D workflows. +* **Voice agents via MCP.** [MCP-Powered Agentic Voice Framework](docs/openai_mcp_voice_agents_cookbook.md) demonstrates orchestrating tool-calling voice interfaces with the Model Context Protocol. +* **Model selection playbook.** [Practical Guide for Model Selection](docs/openai_model_selection_cookbook.md) offers decision frameworks for choosing among GPT-4.1, o3, and o4-mini. +* **Graph-based retrieval.** [RAG with Graph Databases](docs/openai_rag_graph_db_cookbook.md) combines Neo4j graphs and LLMs for relationship-aware context fetching. +* **3D embedding plots.** [Visualizing Embeddings in 3D](docs/openai_visualizing_embeddings_3d_cookbook.md) applies PCA to project high-dimensional vectors into spatial plots. +* **Vector store integrations.** [Vector Database Guides](docs/openai_vector_database_guides.md) catalog storage options for semantic search. +* **Dynamic tool execution.** [Dynamic Code Interpreter for Agents](docs/openai_dynamic_code_interpreter_cookbook.md) explores on-the-fly code generation and execution with o3-mini. +* **Manus AI perspective.** The PDFs ["The K3D Advantage: A Paradigm Shift for Internal AI Memory"](docs/reports/manus_k3d_advantage.pdf) and ["The K3D Catalyst: Fostering Human-Like Reasoning and Intuition in AI"](docs/reports/manus_k3d_catalyst.pdf) are both signed by **Manus AI**. +* **AR vision with an AI coauthor.** "Integrating Augmented Reality and AI: New Frontiers in Training, Learning, and Exploration" expands on Daniel Campos Ramos' ideas in partnership with an **AI assistant**. +* **Interactive demo.** The HTML file ["K3D Gemini report"](docs/reports/k3d_gemini_report.html) showcases a simple web report generated using **Google Gemini**. +* **ChatGPT agent research.** ["ChatGPT Agent - K3D paradigm research"](docs/reports/chatgpt_k3d_research.docx) collects exploratory notes from early conversations with the OpenAI model. +* **Industry impact deck.** ["ChatGPT Agent - Impact of the K3D Paradigm on BIM and Additive Manufacturing"](docs/presentations/chatgpt_k3d_bim_am.pptx) and the spreadsheet ["ChatGPT Agent - Impact_Domains.xlsx"](docs/reports/chatgpt_impact_domains.xlsx) map potential use cases across sectors. +* **Claude's perspective.** ["Claude - Collective Intelligence in Shared K3D Space"](docs/papers/claude_collective_intelligence.pdf) summarizes Anthropic's take on collaborative 3D knowledge worlds. +* **Concept slides.** ["From_Pages_to_Spaces.pptx"](docs/presentations/from_pages_to_spaces.pptx) visualizes how web pages could evolve into immersive spaces. +* **Deep research notes.** ["Gemini DeepResearch Report"](docs/reports/gemini_deep_research_report.docx) chronicles brainstorming sessions prior to the Gemini coauthored paper. +* **Perplexity AI review.** ["Expert Assessment - Perplexity AI"](docs/reports/perplexity_ai_assessment.docx) offers an outside evaluation of the K3D paradigm from **Perplexity AI**. +* **Portuguese reflections.** ["Como eu, como IA, me beneficiaria ao integrar uma"](docs/papers/portuguese_ai_integration.docx) and ["Is this idea too different that it requires a comp"](docs/papers/portuguese_is_idea_too_different.docx) capture additional ChatGPT analysis in Portuguese. +* **Audio discussion.** ["Spatial Web & K3D: Your Future of Immersive Knowledge and AI Collaboration.mpga"](docs/spatial_web_k3d_discussion.mpga) captures an informal conversation about the Spatial Web. +* **Screenshot preview.** ["Screenshot_20250730_153941.png"](docs/viewer_preview.png) shows an early build of the planned 3D viewer. + +## EchoSystems Action Plan + +The project now aligns with the **EchoSystems K3D Collaboration Action Plan**. Key directives are: + +- **Guiding principles** – form↔meaning, show‑don’t‑scroll, edge‑first and open‑by‑default. +- **Four‑Pillar stack** – design craft, persuasive psychology, frontend velocity and system design & DevOps. +- **Reference architecture** – data and graph layers share a `K3D‑Node` schema ([`spec/k3d_node_schema.json`](spec/k3d_node_schema.json)). + +See [`echo_systems_k_3_d_action_plan_v_0.md`](docs/reports/echo_systems_k_3_d_action_plan_v_0.md) for the full document. + +## TeleKnowledge vision + +The companion paper *["Towards an Interactive __TeleKnowledge__ Internet: A 3D Virtual World for Businesses, Humans, and AI"](docs/papers/teleknoledge_internet.docx)* expands on the long‑term ambition for Knowledge3D. It imagines a **Spatial Web** where self‑hosted virtual buildings replace today’s static pages. Using open protocols such as the IEEE 2874 Hyperspace Transaction Protocol (HSTP) and its HSML modeling language, any organization could serve a richly interactive 3D environment under its own domain while still linking seamlessly to others. Built‑in decentralized identifiers control access so both humans and AI agents can explore knowledge spaces safely and transparently. + +## Potential collaborators + +Knowledge3D aims to cooperate with organizations building an open 3D internet. Notable groups include: + +- [Spatial Web Foundation](https://github.com/Spatial-Web-Foundation) +- [Verses AI](https://github.com/Versesai) +- [MSquared](https://github.com/msquared) +- [mml‑io](https://github.com/mml-io/mml) – Metaverse Markup Language +- [Niantic](https://github.com/Niantic) – Lightship AR platform +- [Brilliant Labs](https://github.com/brilliantlabsAR) +- [Meta](https://github.com/meta) +- [Apple](https://github.com/apple) +- [Google](https://github.com/google) +- [Autodesk](https://github.com/Autodesk) +- [Decentraland](https://github.com/decentraland) +- [OpenAI](https://github.com/openai) + +## Installation + +Install the project in editable mode to expose the `k3dgen` command: + +```bash +pip install -e . +``` + +## Quick start + +Generate the example dataset using the `k3dgen` CLI: + +```bash +python -m k3dgen examples/sample_vectors.csv --gltf examples/sample_output.gltf --k3d examples/sample_output.k3d +``` + +The command writes both `examples/sample_output.gltf` and `examples/sample_output.k3d`. + +## Browser viewer + +To explore the generated dataset in 3D: + +```bash +cd viewer +npm install +npm run dev +``` + +This launches a local server that renders `examples/sample_output.gltf` and shows point IDs on hover. + +![Viewer preview](docs/viewer_preview.png) + +## Licensing + +All code in this repository is released under the Apache‑2.0 License. The white‑paper and related text documents are distributed under the Creative Commons Attribution 4.0 International (CC‑BY‑4.0) license. See [`/docs/LICENSE-CC-BY-4.0.txt`](docs/LICENSE-CC-BY-4.0.txt) for the full CC‑BY‑4.0 text. GitHub may report "No license" for the documentation, but this file is authoritative. + +For the development roadmap see [docs/ROADMAP.md](docs/ROADMAP.md). Codex agents coordinating work should consult [CODEX.md](CODEX.md). Development conventions are summarized in [docs/DEV_GUIDELINES.md](docs/DEV_GUIDELINES.md). diff --git a/knowledge3d.egg-info/SOURCES.txt b/knowledge3d.egg-info/SOURCES.txt new file mode 100644 index 00000000..c10d95b1 --- /dev/null +++ b/knowledge3d.egg-info/SOURCES.txt @@ -0,0 +1,13 @@ +LICENSE +NOTICE +README.md +pyproject.toml +k3dgen/__init__.py +k3dgen/__main__.py +knowledge3d.egg-info/PKG-INFO +knowledge3d.egg-info/SOURCES.txt +knowledge3d.egg-info/dependency_links.txt +knowledge3d.egg-info/entry_points.txt +knowledge3d.egg-info/requires.txt +knowledge3d.egg-info/top_level.txt +tests/test_k3dgen.py \ No newline at end of file diff --git a/knowledge3d.egg-info/dependency_links.txt b/knowledge3d.egg-info/dependency_links.txt new file mode 100644 index 00000000..e69de29b diff --git a/knowledge3d.egg-info/entry_points.txt b/knowledge3d.egg-info/entry_points.txt new file mode 100644 index 00000000..40c4f7aa --- /dev/null +++ b/knowledge3d.egg-info/entry_points.txt @@ -0,0 +1,2 @@ +[console_scripts] +k3dgen = k3dgen.__main__:main diff --git a/knowledge3d.egg-info/requires.txt b/knowledge3d.egg-info/requires.txt new file mode 100644 index 00000000..7641cbfe --- /dev/null +++ b/knowledge3d.egg-info/requires.txt @@ -0,0 +1,4 @@ +pandas +numpy +scikit-learn +pygltflib diff --git a/knowledge3d.egg-info/top_level.txt b/knowledge3d.egg-info/top_level.txt new file mode 100644 index 00000000..3240629d --- /dev/null +++ b/knowledge3d.egg-info/top_level.txt @@ -0,0 +1 @@ +k3dgen