homesec 0.1.0__tar.gz → 0.1.1__tar.gz

{homesec-0.1.0 → homesec-0.1.1}/.gitignore

@@ -2,3 +2,4 @@ video_cache/
 *.pt
 .env
 __pycache__/
+dist

homesec-0.1.1/.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

homesec-0.1.1/.idea/homesec.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

homesec-0.1.1/.idea/libraries/my_test_package.xml

@@ -0,0 +1,9 @@
+<component name="libraryTable">
+  <library name="my-test-package">
+    <CLASSES>
+      <root url="jar://$PROJECT_DIR$/.venv/lib/python3.14/site-packages/pkg_resources/tests/data/my-test-package-zip/my-test-package.zip!/" />
+    </CLASSES>
+    <JAVADOC />
+    <SOURCES />
+  </library>
+</component>

homesec-0.1.1/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="openjdk-21" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

homesec-0.1.1/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/homesec.iml" filepath="$PROJECT_DIR$/.idea/homesec.iml" />
+    </modules>
+  </component>
+</project>

homesec-0.1.1/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

homesec-0.1.1/.idea/workspace.xml

@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ChangeListManager">
+    <list default="true" id="33313ace-5c3b-4532-abc0-26bda0c300f7" name="Changes" comment="">
+      <change beforePath="$PROJECT_DIR$/Makefile" beforeDir="false" afterPath="$PROJECT_DIR$/Makefile" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/homesec/__init__.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/homesec/__init__.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/uv.lock" beforeDir="false" afterPath="$PROJECT_DIR$/uv.lock" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 7
+}]]></component>
+  <component name="ProjectId" id="385rR38zU8CFOYRby1hUP1t3Ubh" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "kotlin-language-version-configured": "true",
+    "last_opened_file_path": "/Users/levneiman/code/homesec",
+    "nodejs_package_manager_path": "npm"
+  }
+}]]></component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-jdk-30f59d01ecdd-26cb7f24e5b0-intellij.indexing.shared.core-IU-253.29346.138" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="33313ace-5c3b-4532-abc0-26bda0c300f7" name="Changes" comment="" />
+      <created>1768100260356</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1768100260356</updated>
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

{homesec-0.1.0 → homesec-0.1.1}/Makefile

@@ -3,7 +3,7 @@ SHELL := /bin/bash
 
 .PHONY: help homesec test typecheck check
 .PHONY: db-up db-down db-logs db-migrate db-migrate-homesec
-.PHONY: pypi-build pypi-check pypi-publish
+.PHONY: pypi-clean pypi-build pypi-check pypi-publish
 
 help:
 	@echo "Targets:"
@@ -16,6 +16,7 @@ help:
 	@echo "  make db-logs    Tail Postgres logs (telemetry)"
 	@echo "  make db-migrate Run alembic migrations (telemetry + clip state/events)"
 	@echo "  make db-migrate-homesec Run alembic migrations (clip state/events)"
+	@echo "  make pypi-clean    Remove local build artifacts (dist/, build/)"
 	@echo "  make pypi-build    Build sdist/wheel for PyPI"
 	@echo "  make pypi-check    Validate dist artifacts with twine"
 	@echo "  make pypi-publish  Build, check, and upload to PyPI"
@@ -51,7 +52,10 @@ db-migrate:
 db-migrate-homesec:
 	$(MAKE) db-migrate
 
-pypi-build: check
+pypi-clean:
+	rm -rf dist build
+
+pypi-build: pypi-clean check
 	uv run --with build python -m build
 
 pypi-check:

{homesec-0.1.0 → homesec-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homesec
-Version: 0.1.0
+Version: 0.1.1
 Summary: Pluggable async home security camera pipeline with detection, VLM analysis, and alerts.
 Project-URL: Homepage, https://github.com/lan17/homesec
 Project-URL: Source, https://github.com/lan17/homesec
@@ -261,6 +261,7 @@ best-effort, and non-critical stages can fail without losing the alert.
 - Policy-driven alerts with per-camera overrides
 - Fan-out notifiers (MQTT for Home Assistant, SendGrid email)
 - Postgres-backed state + events with graceful degradation
+- Built around small, stable interfaces so new plugins drop in cleanly
 - Health endpoint plus optional Postgres telemetry logging
 
 ## Pipeline at a glance
@@ -377,6 +378,27 @@ storage:
 - For a quick local run, pair `local_folder` with `local` storage and drop a clip
   into `recordings/`.
 
+## Extensible by design
+
+HomeSec is intentionally modular. Each major capability is an interface
+(`ClipSource`, `StorageBackend`, `ObjectFilter`, `VLMAnalyzer`, `AlertPolicy`,
+`Notifier`) defined in `src/homesec/interfaces.py`, and plugins are discovered at
+runtime via entry points. This keeps the core pipeline small while making it
+easy to add new backends without editing core code.
+
+What this means in practice:
+- Swap storage or notifications by changing config, not code.
+- Add a new plugin type as a separate package and register it.
+- Keep config validation strict by pairing each plugin with a Pydantic model.
+
+Extension points (all pluggable):
+- Sources: RTSP motion detection, FTP uploads, local folders
+- Storage backends: Dropbox, local disk, or your own
+- Filters: object detection (YOLO or custom models)
+- VLM analyzers: OpenAI-compatible APIs or local models
+- Alert policies: per-camera rules and thresholds
+- Notifiers: MQTT, email, or anything else you can send from Python
+
 ## CLI
 
 - Run the pipeline:
@@ -399,6 +421,11 @@ storage:
 HomeSec discovers plugins via entry points in the `homesec.plugins` group. A plugin
 module just needs to import and register itself.
 
+Each plugin provides:
+- A unique name (used in config)
+- A Pydantic config model for validation
+- A factory that builds the concrete implementation
+
 ```python
 # my_package/filters/custom.py
 from pydantic import BaseModel

{homesec-0.1.0 → homesec-0.1.1}/README.md

@@ -18,6 +18,7 @@ best-effort, and non-critical stages can fail without losing the alert.
 - Policy-driven alerts with per-camera overrides
 - Fan-out notifiers (MQTT for Home Assistant, SendGrid email)
 - Postgres-backed state + events with graceful degradation
+- Built around small, stable interfaces so new plugins drop in cleanly
 - Health endpoint plus optional Postgres telemetry logging
 
 ## Pipeline at a glance
@@ -134,6 +135,27 @@ storage:
 - For a quick local run, pair `local_folder` with `local` storage and drop a clip
   into `recordings/`.
 
+## Extensible by design
+
+HomeSec is intentionally modular. Each major capability is an interface
+(`ClipSource`, `StorageBackend`, `ObjectFilter`, `VLMAnalyzer`, `AlertPolicy`,
+`Notifier`) defined in `src/homesec/interfaces.py`, and plugins are discovered at
+runtime via entry points. This keeps the core pipeline small while making it
+easy to add new backends without editing core code.
+
+What this means in practice:
+- Swap storage or notifications by changing config, not code.
+- Add a new plugin type as a separate package and register it.
+- Keep config validation strict by pairing each plugin with a Pydantic model.
+
+Extension points (all pluggable):
+- Sources: RTSP motion detection, FTP uploads, local folders
+- Storage backends: Dropbox, local disk, or your own
+- Filters: object detection (YOLO or custom models)
+- VLM analyzers: OpenAI-compatible APIs or local models
+- Alert policies: per-camera rules and thresholds
+- Notifiers: MQTT, email, or anything else you can send from Python
+
 ## CLI
 
 - Run the pipeline:
@@ -156,6 +178,11 @@ storage:
 HomeSec discovers plugins via entry points in the `homesec.plugins` group. A plugin
 module just needs to import and register itself.
 
+Each plugin provides:
+- A unique name (used in config)
+- A Pydantic config model for validation
+- A factory that builds the concrete implementation
+
 ```python
 # my_package/filters/custom.py
 from pydantic import BaseModel

{homesec-0.1.0 → homesec-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "homesec"
-version = "0.1.0"
+version = "0.1.1"
 description = "Pluggable async home security camera pipeline with detection, VLM analysis, and alerts."
 readme = "README.md"
 authors = [

{homesec-0.1.0 → homesec-0.1.1}/src/homesec/__init__.py

@@ -1,6 +1,6 @@
 """HomeSec camera pipeline."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 
 # Export commonly used types
 from homesec.errors import PipelineError

{homesec-0.1.0 → homesec-0.1.1}/uv.lock

@@ -731,7 +731,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -1021,7 +1021,7 @@ wheels = [
 
 [[package]]
 name = "homesec"
-version = "0.1.0"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },