Initial commit: HereIAm mouse movement monitor

- Complete macOS application with PyQt5 GUI
- Smart mouse monitoring with configurable timing
- System menu bar integration with adaptive theming
- Comprehensive build system with PyInstaller
- Professional DMG creation for distribution
- Full documentation and testing scripts

setup.py

@@ -0,0 +1,50 @@
+from setuptools import setup, find_packages
+import os
+
+# Read README for long description
+def read_readme():
+    with open("README.md", "r", encoding="utf-8") as fh:
+        return fh.read()
+
+setup(
+    name='HereIAm',
+    version='1.0.0',
+    description='A macOS application that moves the mouse cursor to prevent inactivity.',
+    long_description=read_readme(),
+    long_description_content_type="text/markdown",
+    author='Jerico Thomas',
+    author_email='jerico@tekop.net',
+    url='https://github.com/your-username/hereiam',  # Update with your repo URL
+    packages=find_packages(),
+    package_data={
+        'assets': ['*.icns', '*.png'],
+    },
+    include_package_data=True,
+    install_requires=[
+        'pyautogui>=0.9.54',
+        'PyQt5>=5.15.0',
+        'pyobjc-framework-Cocoa>=9.0',
+        'pyobjc-framework-Quartz>=9.0',
+    ],
+    python_requires='>=3.8',
+    entry_points={
+        'console_scripts': [
+            'hereiam=src.main:main',
+        ],
+        'gui_scripts': [
+            'hereiam-gui=src.main:main',
+        ],
+    },
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: End Users/Desktop",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: MacOS",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Topic :: Utilities",
+    ],
+)