astrocyte-stack 0.1.0__tar.gz

astrocyte_stack-0.1.0/.gitignore

@@ -0,0 +1,56 @@
+# Node (Starlight in docs/)
+node_modules/
+.pnpm-store/
+docs/.astro/
+
+# Generated by docs/scripts/fetch-pypi-pins.mjs (recreated on every pnpm dev/build)
+docs/src/data/pypi-install-pins.json
+
+# Generated by docs/scripts/sync-docs.mjs (recreated on every pnpm dev/build)
+docs/src/content/docs/introduction.md
+docs/src/content/docs/design/
+docs/src/content/docs/plugins/
+docs/src/content/docs/end-user/
+docs/src/content/docs/tutorials/
+
+# Claude Code
+.claude/
+
+# OS
+.DS_Store
+
+# Local reference material (not tracked)
+references/
+
+# nWave feature artifacts (per-feature discover/deliver, roadmaps, execution logs).
+# Intended to be a separate private worktree or nested git repo; not part of public Astrocyte.
+docs/feature/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+venv/
+.env
+.env.*
+!.env.example
+*.egg-info/
+.eggs/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+benchmark-results/
+datasets/
+
+# Rust
+target/
+
+# IDE (optional)
+.idea/
+astrocyte-py/logs/
+astrocyte-py/logs/ # if not already there

astrocyte_stack-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: astrocyte-stack
+Version: 0.1.0
+Summary: Convenience meta-package: pulls Astrocyte's default production stack (astrocyte + astrocyte-postgres).
+Project-URL: Homepage, https://github.com/AstrocyteAI/astrocyte
+Project-URL: Documentation, https://AstrocyteAI.github.io/astrocyte/
+Project-URL: Source, https://github.com/AstrocyteAI/astrocyte
+Project-URL: Issues, https://github.com/AstrocyteAI/astrocyte/issues
+Author-email: Calvin Cheng <linchuan.cheng@gmail.com>
+License-Expression: Apache-2.0
+Keywords: agent-memory,astrocyte,meta-package
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: astrocyte[default]<2,>=0.13.1
+Description-Content-Type: text/markdown
+
+# astrocyte-stack
+
+Convenience meta-package for Astrocyte's default production stack.
+
+```bash
+pip install astrocyte-stack
+```
+
+That's it. Equivalent to:
+
+```bash
+pip install "astrocyte[default]"
+# which itself resolves to:
+pip install astrocyte astrocyte-postgres
+```
+
+## Why a separate package
+
+`astrocyte-stack` exists so the recommended install is one short copy-paste,
+not three packages or a square-bracket extras string. The trade-off:
+
+- Library / framework consumers (`pip install astrocyte`) get a thin install
+  with only the SPI types and in-memory backends. ~11 packages.
+- Production / quick-start consumers (`pip install astrocyte-stack`) get the
+  Postgres-backed brain that the docs assume. ~18 packages.
+- The default stack can evolve (e.g. swapping the default vector backend
+  later) without `astrocyte` itself growing dependencies.
+
+## What's inside
+
+Only a dependency declaration. There is no `astrocyte_stack` Python API.
+For actual usage, `import astrocyte` — see
+[the quick-start](https://AstrocyteAI.github.io/astrocyte/end-user/quick-start/).
+
+## Choosing a different default
+
+If you want a non-Postgres backend, install `astrocyte` directly with the
+relevant per-adapter extra:
+
+```bash
+pip install "astrocyte[qdrant]"          # Qdrant vector store
+pip install "astrocyte[neo4j]"           # Neo4j graph store
+pip install "astrocyte[elasticsearch]"   # Elasticsearch document store
+```
+
+Or browse the [ecosystem and packaging guide](https://AstrocyteAI.github.io/astrocyte/plugins/ecosystem-and-packaging/)
+for the full matrix of optional dependencies.
+
+## License
+
+Apache-2.0. See [LICENSE](../../LICENSE).

astrocyte_stack-0.1.0/README.md

@@ -0,0 +1,51 @@
+# astrocyte-stack
+
+Convenience meta-package for Astrocyte's default production stack.
+
+```bash
+pip install astrocyte-stack
+```
+
+That's it. Equivalent to:
+
+```bash
+pip install "astrocyte[default]"
+# which itself resolves to:
+pip install astrocyte astrocyte-postgres
+```
+
+## Why a separate package
+
+`astrocyte-stack` exists so the recommended install is one short copy-paste,
+not three packages or a square-bracket extras string. The trade-off:
+
+- Library / framework consumers (`pip install astrocyte`) get a thin install
+  with only the SPI types and in-memory backends. ~11 packages.
+- Production / quick-start consumers (`pip install astrocyte-stack`) get the
+  Postgres-backed brain that the docs assume. ~18 packages.
+- The default stack can evolve (e.g. swapping the default vector backend
+  later) without `astrocyte` itself growing dependencies.
+
+## What's inside
+
+Only a dependency declaration. There is no `astrocyte_stack` Python API.
+For actual usage, `import astrocyte` — see
+[the quick-start](https://AstrocyteAI.github.io/astrocyte/end-user/quick-start/).
+
+## Choosing a different default
+
+If you want a non-Postgres backend, install `astrocyte` directly with the
+relevant per-adapter extra:
+
+```bash
+pip install "astrocyte[qdrant]"          # Qdrant vector store
+pip install "astrocyte[neo4j]"           # Neo4j graph store
+pip install "astrocyte[elasticsearch]"   # Elasticsearch document store
+```
+
+Or browse the [ecosystem and packaging guide](https://AstrocyteAI.github.io/astrocyte/plugins/ecosystem-and-packaging/)
+for the full matrix of optional dependencies.
+
+## License
+
+Apache-2.0. See [LICENSE](../../LICENSE).

astrocyte_stack-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "astrocyte-stack"
+version = "0.1.0"
+description = "Convenience meta-package: pulls Astrocyte's default production stack (astrocyte + astrocyte-postgres)."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.11"
+authors = [
+    { name = "Calvin Cheng", email = "linchuan.cheng@gmail.com" },
+]
+keywords = ["astrocyte", "agent-memory", "meta-package"]
+classifiers = [
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+# This package has no Python code of its own. It exists so that
+# ``pip install astrocyte-stack`` is the one-liner for the recommended
+# "just works" install, equivalent to ``pip install astrocyte[default]``.
+# Defined here as a separate package (rather than only as an extra) so:
+#   - the install command is shorter and easier to copy from docs
+#   - the default stack can evolve without ``astrocyte`` itself adding
+#     deps (e.g. flipping the default vector backend in 18 months changes
+#     this file, not ``astrocyte``)
+#   - dependency-pinning consumers can ``astrocyte-stack==X.Y.Z`` to lock
+#     the whole stack at once
+dependencies = [
+    "astrocyte[default]>=0.13.1,<2",
+]
+
+[project.urls]
+Homepage = "https://github.com/AstrocyteAI/astrocyte"
+Documentation = "https://AstrocyteAI.github.io/astrocyte/"
+Source = "https://github.com/AstrocyteAI/astrocyte"
+Issues = "https://github.com/AstrocyteAI/astrocyte/issues"
+
+# Source layout: empty src/ tree. Hatchling needs *something* to package;
+# an empty Python module ``astrocyte_stack/__init__.py`` satisfies that.
+[tool.hatch.build.targets.wheel]
+packages = ["src/astrocyte_stack"]
+
+# Local-dev source resolution — only used by ``uv sync`` inside this repo.
+# Drops out of the published wheel.
+[tool.uv.sources]
+astrocyte = { path = "../../astrocyte-py", editable = true }
+
+[tool.ruff]
+line-length = 100

astrocyte_stack-0.1.0/src/astrocyte_stack/__init__.py

@@ -0,0 +1,12 @@
+"""astrocyte-stack — convenience meta-package.
+
+This module exists only so the wheel has something to install. The
+real value of ``pip install astrocyte-stack`` is the dependency
+declaration in ``pyproject.toml`` that pulls
+``astrocyte[default]`` (= ``astrocyte`` + ``astrocyte-postgres``).
+
+For library use, ``import astrocyte`` directly — there is no
+``astrocyte_stack`` API to call.
+"""
+
+__version__ = "0.1.0"