{"id":30418714,"url":"https://github.com/qompassai/python","last_synced_at":"2026-05-15T13:35:38.144Z","repository":{"id":290492868,"uuid":"971630702","full_name":"qompassai/Python","owner":"qompassai","description":"Qompass AI On Python","archived":false,"fork":false,"pushed_at":"2026-05-10T06:54:16.000Z","size":417114,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-10T08:36:36.127Z","etag":null,"topics":["ai","conda","education","equator","python","pytorch"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qompassai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE-AGPL","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"phaedrusflow","liberapay":"qompassai","patreon":"qompassai","open_collective":"qompassai","custom":["https://www.buymeacoffee.com/phaedrusflow","https://monero.com/donate/?address=42HGspSFJQ4MjM5ZusAiKZj9JZWhfNgVraKb1eGCsHoC6QJqpo2ERCBZDhhKfByVjECernQ6KeZwFcnq8hVwTTnD8v4PzyH"]}},"created_at":"2025-04-23T20:18:29.000Z","updated_at":"2026-05-10T06:54:29.000Z","dependencies_parsed_at":"2025-05-30T06:27:55.030Z","dependency_job_id":"3845ccd2-2b5c-4454-94ce-9edb4b737990","html_url":"https://github.com/qompassai/Python","commit_stats":null,"previous_names":["qompassai/python"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/qompassai/Python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qompassai%2FPython","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qompassai%2FPython/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qompassai%2FPython/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qompassai%2FPython/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qompassai","download_url":"https://codeload.github.com/qompassai/Python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qompassai%2FPython/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33068719,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","conda","education","equator","python","pytorch"],"created_at":"2025-08-22T07:47:18.510Z","updated_at":"2026-05-15T13:35:38.123Z","avatar_url":"https://github.com/qompassai.png","language":"Jupyter Notebook","funding_links":["https://github.com/sponsors/phaedrusflow","https://liberapay.com/qompassai","https://patreon.com/qompassai","https://opencollective.com/qompassai","https://www.buymeacoffee.com/phaedrusflow","https://monero.com/donate/?address=42HGspSFJQ4MjM5ZusAiKZj9JZWhfNgVraKb1eGCsHoC6QJqpo2ERCBZDhhKfByVjECernQ6KeZwFcnq8hVwTTnD8v4PzyH"],"categories":[],"sub_categories":[],"readme":"\u003c!--/qompassai/python/README.md --\u003e\n\u003c!-- ------------------------------ --\u003e\n\u003c!-- Copyright (C) 2025 Qompass AI, All rights reserved --\u003e\n\n\u003ch2\u003e Python: The OG of AI \u003c/h2\u003e\n\n\u003ch3\u003e Qompass AI on Python \u003c/h3\u003e\n\n![Repository Views](https://komarev.com/ghpvc/?username=qompassai-python)\n![GitHub all releases](https://img.shields.io/github/downloads/qompassai/python/total?style=flat-square)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white\" alt=\"Python\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003ca href=\"https://docs.python.org/3/\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python_Documentation-blue?style=flat-square\" alt=\"Python Documentation\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/topics/python-tutorial\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python_Tutorials-green?style=flat-square\" alt=\"Python Tutorials\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n  \u003ca href=\"https://www.gnu.org/licenses/agpl-3.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-AGPL%20v3-blue.svg\" alt=\"License: AGPL v3\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE-QCDA\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Q--CDA-lightgrey.svg\" alt=\"License: Q-CDA\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdetails\u003e\n  \u003csummary style=\"font-size: 1.4em; font-weight: bold; padding: 15px; background: #667eea; color: white; border-radius: 10px; cursor: pointer; margin: 10px 0;\"\u003e\n    \u003cstrong\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/qompassai/svg/main/assets/icons/python/python.svg\"\n           alt=\"Qmopass AI Python Logo\"\n           style=\"height: 1em; vertical-align: -0.2em; margin-right: 0.25em;\" /\u003e\n      Python Solutions     \u003c/strong\u003e\n  \u003c/summary\u003e\n  \u003cdiv style=\"background: #f8f9fa; padding: 15px; border-radius: 5px; margin-top: 10px; font-family: monospace;\"\u003e\n\n* [Qompass Radar](https://github.com/qompassai/radar)    \n* [Qompass Qonfig](https://github.com/qompassai/qonfig)\n\n  \u003c/div\u003e\n\n\u003cdetails\u003e\n  \u003csummary style=\"font-size: 1.4em; font-weight: bold; padding: 15px; background: #667eea; color: white; border-radius: 10px; cursor: pointer; margin: 10px 0;\"\u003e\n    \u003cstrong\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/qompassai/svg/main/assets/icons/edu/edu.svg\"\n           alt=\"Ferris the Crab\"\n           style=\"height: 1em; vertical-align: -0.2em; margin-right: 0.25em;\" /\u003e\n      Educational Videos\n    \u003c/strong\u003e\n  \u003c/summary\u003e\n  \u003cdiv style=\"background: #f8f9fa; padding: 15px; border-radius: 5px; margin-top: 10px; font-family: monospace;\"\u003e\n\n  [![Making Python useful for AI datasets](https://img.youtube.com/vi/T-XGHgaJIPU/hqdefault.jpg)](https://www.youtube.com/watch?v=T-XGHgaJIPU\u0026t=511s)\n\n  \u003c/div\u003e\n\n\u003c/details\u003e\n\u003c/details\u003e\n\n  \u003cdetails\u003e\n  \u003csummary style=\"font-size: 1.4em; font-weight: bold; padding: 15px; background: #667eea; color: white; border-radius: 10px; cursor: pointer; margin: 10px 0;\"\u003e\n    \u003cstrong\u003e▶️ Qompass AI Quick Start\u003c/strong\u003e\n  \u003c/summary\u003e\n  \u003cdiv style=\"background: #f8f9fa; padding: 15px; border-radius: 5px; margin-top: 10px; font-family: monospace;\"\u003e\n\n```sh  \ncurl -fsSL https://raw.githubusercontent.com/qompassai/python/main/scripts/quickstart.sh | sh\n```\n  \u003c/div\u003e\n  \u003cblockquote style=\"font-size: 1.2em; line-height: 1.8; padding: 25px; background: #f8f9fa; border-left: 6px solid #667eea; border-radius: 8px; margin: 15px 0; box-shadow: 0 2px 8px rgba(0,0,0,0.1);\"\u003e\n    \u003cdetails\u003e\n      \u003csummary style=\"font-size: 1em; font-weight: bold; padding: 10px; background: #e9ecef; color: #333; border-radius: 5px; cursor: pointer; margin: 10px 0;\"\u003e\n        \u003cstrong\u003e📄 We advise you read the script BEFORE running it 😉\u003c/strong\u003e\n      \u003c/summary\u003e\n      \u003cpre style=\"background: #fff; padding: 15px; border-radius: 5px; border: 1px solid #ddd; overflow-x: auto;\"\u003e\n#!/bin/sh\n# /qompassai/python/scripts/quickstart.sh\n# Qompass AI Python Quick Start\n# Copyright (C) 2025 Qompass AI, All rights reserved\n#########################################################\nset -eu\nPREFIX=\"$HOME/.local\"\nXDG_CONFIG_HOME=\"${XDG_CONFIG_HOME:-$HOME/.config}\"\nLOCAL_PREFIX=\"$HOME/.local\"\nBIN_DIR=\"$LOCAL_PREFIX/bin\"\nLIB_DIR=\"$LOCAL_PREFIX/lib\"\nSHARE_DIR=\"$LOCAL_PREFIX/share\"\nSRC_DIR=\"$LOCAL_PREFIX/src/python\"\nmkdir -p \"$PREFIX/bin\"\nPY_VERSIONS=\"\n1|3.6.15\n2|3.7.17\n3|3.8.19\n4|3.9.19\n5|3.10.14\n6|3.11.9\n7|3.12.3\n8|3.13.5\n9|3.14.0a6\n\"\nprintf '╭────────────────────────────────────────────╮\\n'\nprintf '│      Qompass AI · Python Quick‑Start       │\\n'\nprintf '╰────────────────────────────────────────────╯\\n'\nprintf '   © 2025 Qompass AI. All rights reserved   \\n\\n'\necho \"Which Python version would you like to build?\"\necho \"$PY_VERSIONS\" | while IFS=\"|\" read num version; do\n        [ -z \"$num\" ] \u0026\u0026 continue\n        echo \" $num) Python $version\"\ndone\necho \" a) All\"\necho \" q) Quit\"\nprintf \"Choose [8]: \"\nread -r choice\n[ -z \"$choice\" ] \u0026\u0026 choice=8\n[ \"$choice\" = \"q\" ] \u0026\u0026 exit 0\nPY_FINALS_LIST=\"3.6.15 3.7.17 3.8.19 3.9.19 3.10.14 3.11.9 3.12.3 3.13.5 3.14.0a6\"\nif [ \"$choice\" = \"a\" ] || [ \"$choice\" = \"A\" ]; then\n        VERSIONS_TO_BUILD=\"$PY_FINALS_LIST\"\nelif printf '%s\\n' $PY_FINALS_LIST | awk \"NR==$choice\" | grep -q .; then\n        VERSIONS_TO_BUILD=$(printf '%s\\n' $PY_FINALS_LIST | awk \"NR==$choice\")\nelse\n        echo \"Invalid selection.\" \u003e\u00262\n        exit 1\nfi\necho\necho \"You selected: $VERSIONS_TO_BUILD\"\necho \"Which build configuration?\"\necho \" 1) Classic CPython\"\necho \" 2) Free-threaded (GIL-free, experimental)\"\necho \" 3) Classic with FULL OPTIMIZATIONS (PGO, LTO, LTO_FLAGS)\"\necho \" 4) Free-threaded + FULL OPTIMIZATIONS\"\necho \" q) Quit\"\nprintf \"Choose [1]: \"\nread -r cbuild\n[ -z \"$cbuild\" ] \u0026\u0026 cbuild=1\n[ \"$cbuild\" = \"q\" ] \u0026\u0026 exit 0\nFREE_THREADED=\"no\"\nDO_OPTIMIZE=\"no\"\ncase \"$cbuild\" in\n2) FREE_THREADED=\"yes\" ;;\n3) DO_OPTIMIZE=\"yes\" ;;\n4)\n        FREE_THREADED=\"yes\"\n        DO_OPTIMIZE=\"yes\"\n        ;;\nesac\nfor PY_VERS in $VERSIONS_TO_BUILD; do\n        PY_MAJ=\"$(echo \"$PY_VERS\" | cut -d. -f1-2)\"\n        cd \"$SRC_DIR\"\n        if [ ! -d \"cpython-$PY_VERS\" ]; then\n                echo \"→ Cloning Python source (cpython $PY_VERS)...\"\n                git clone --branch \"v$PY_VERS\" https://github.com/python/cpython.git \"cpython-$PY_VERS\"\n        fi\n        cd \"cpython-$PY_VERS\"\n        git fetch origin\n        git checkout \"v$PY_VERS\"\n        git clean -fdx\n        echo \"→ Configuring Python $PY_VERS build...\"\n        CONFIG_FLAGS=\"--prefix=$LOCAL_PREFIX\"\n        [ \"$FREE_THREADED\" = \"yes\" ] \u0026\u0026 CONFIG_FLAGS=\"$CONFIG_FLAGS --enable-free-threaded-interpreter\"\n        [ \"$DO_OPTIMIZE\" = \"yes\" ] \u0026\u0026 CONFIG_FLAGS=\"$CONFIG_FLAGS --enable-optimizations --with-lto\"\n        ./configure \"$CONFIG_FLAGS\"\n        echo \"→ Building Python $PY_VERS (this may take several minutes)...\"\n        export CFLAGS=\"-Wno-error=date-time\"\n        make -j\"$(nproc)\"\n        echo \"→ Installing Python $PY_VERS (no sudo needed)...\"\n        make install\ndone\ncase \":$PATH:\" in *\":$BIN_DIR:\"*) ;; *) export PATH=\"$BIN_DIR:$PATH\" ;; esac\nadd_path_to_shell_rc() {\n        rcfile=$1\n        line=\"export PATH=\\\"$BIN_DIR:\\$PATH\\\"\"\n        if [ -f \"$rcfile\" ]; then\n                if ! grep -Fxq \"$line\" \"$rcfile\"; then\n                        printf '\\n# Added by Qompass AI Python quickstart script\\n%s\\n' \"$line\" \u003e\u003e\"$rcfile\"\n                        echo \" → Added PATH export to $rcfile\"\n                fi\n        fi\n}\nadd_path_to_shell_rc \"$HOME/.bashrc\"\nadd_path_to_shell_rc \"$HOME/.zshrc\"\nadd_path_to_shell_rc \"$HOME/.profile\"\nPY_MAJ=\"$(echo \"$PY_VERS\" | cut -d. -f1-2)\"\nPIP_PATH=\"$BIN_DIR/pip$PY_MAJ\"\nPYTHON_PATH=\"$BIN_DIR/python$PY_MAJ\"\necho \"→ Upgrading pip and installing core wheels...\"\n\"$PYTHON_PATH\" -m ensurepip --upgrade\n\"$PYTHON_PATH\" -m pip install --upgrade pip wheel setuptools\necho\nprintf \"Do you want to install \\033[1mpyenv\\033[0m for managing multiple Pythons? [Y/n]: \"\nread -r ans\n[ -z \"$ans\" ] \u0026\u0026 ans=\"Y\"\nif [ \"$ans\" = \"Y\" ] || [ \"$ans\" = \"y\" ]; then\n        if [ ! -d \"$PYENV_ROOT\" ]; then\n                curl -fsSL https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash\n                for rc in \"$HOME/.bashrc\" \"$HOME/.zshrc\" \"$HOME/.profile\"; do\n                        if [ -f \"$rc\" ]; then\n                                if ! grep -q \"pyenv init\" \"$rc\"; then\n                                        printf \"\\n# Pyenv config\\nexport PYENV_ROOT=\\\"%s\\\"\\nexport PATH=\\\"\\\\\\$PYENV_ROOT/bin:\\\\\\$PATH\\\"\\neval \\\"\\\\\\$(pyenv init --path)\\\"\\n\" \"$PYENV_ROOT\" \u003e\u003e\"$rc\"\n                                        echo \" → Added pyenv setup to $rc\"\n                                fi\n                        fi\n                done\n        else\n                echo \"→ pyenv already present.\"\n        fi\nfi\necho\nprintf \"Do you want to install \\033[1mruff\\033[0m (fast Python linter)? [Y/n]: \"\nread -r ans\n[ -z \"$ans\" ] \u0026\u0026 ans=\"Y\"\nif [ \"$ans\" = \"Y\" ] || [ \"$ans\" = \"y\" ]; then\n        \"$PIP_PATH\" install --user ruff\n        echo \"→ ruff installed via pip\"\nfi\necho\nprintf \"Do you want to install \\033[1muv\\033[0m (pip replacement and package manager)? [Y/n]: \"\nread -r ans\n[ -z \"$ans\" ] \u0026\u0026 ans=\"Y\"\nif [ \"$ans\" = \"Y\" ] || [ \"$ans\" = \"y\" ]; then\n        if command -v pipx \u003e/dev/null 2\u003e\u00261; then\n                pipx install uv || \"$PIP_PATH\" install --user uv\n        else\n                \"$PIP_PATH\" install --user uv\n        fi\n        echo \"→ uv installed\"\nfi\necho\necho \"Would you like to install editor tooling for Python development?\"\necho \" 1) python-lsp-server (LSP support, compatible with most editors)\"\necho \" 2) pyright (Microsoft, static type checker/LSP, Node.js required)\"\necho \" 3) basedpyright (Rust-based, fast drop-in Pyright alternative, LSP)\"\necho \" 4) debugpy (VSCode-compatible debugger, works in editors/Jupyter)\"\necho \" 5) ipython (enhanced interactive Python prompt)\"\necho \" 6) pdbpp (better pdb, drop-in REPL/debugger)\"\necho \" a) All of the above\"\necho \" n) None (skip)\"\nprintf \"Choose [a]: \"\nread -r pytools_ans\n[ -z \"$pytools_ans\" ] \u0026\u0026 pytools_ans=\"a\"\nINSTALL_LSP_TOOL() {\n        tool=\"$1\"\n        pkg=\"$2\"\n        if [ \"$tool\" = \"pyright\" ]; then\n                if command -v npm \u003e/dev/null 2\u003e\u00261; then\n                        echo \"→ Installing pyright (npm)...\"\n                        npm install -g pyright\n                else\n                        echo \"npm not found, falling back to pipx/pip.\"\n                        if command -v pipx \u003e/dev/null 2\u003e\u00261; then\n                                pipx install pyright\n                        else\n                                \"$PIP_PATH\" install --user pyright\n                        fi\n                fi\n        elif [ \"$tool\" = \"basedpyright\" ]; then\n                if command -v pipx \u003e/dev/null 2\u003e\u00261; then\n                        echo \"→ Installing basedpyright (pipx)...\"\n                        pipx install basedpyright\n                else\n                        \"$PIP_PATH\" install --user basedpyright\n                fi\n        else\n                echo \"→ Installing $tool...\"\n                \"$PIP_PATH\" install --user \"$pkg\"\n        fi\n}\ncase \"$pytools_ans\" in\n1) INSTALL_LSP_TOOL \"python-lsp-server\" \"python-lsp-server[all]\" ;;\n2) INSTALL_LSP_TOOL \"pyright\" \"pyright\" ;;\n3) INSTALL_LSP_TOOL \"basedpyright\" \"basedpyright\" ;;\n4) INSTALL_LSP_TOOL \"debugpy\" \"debugpy\" ;;\n5) INSTALL_LSP_TOOL \"ipython\" \"ipython\" ;;\n6) INSTALL_LSP_TOOL \"pdbpp\" \"pdbpp\" ;;\na | A)\n        INSTALL_LSP_TOOL \"python-lsp-server\" \"python-lsp-server[all]\"\n        INSTALL_LSP_TOOL \"pyright\" \"pyright\"\n        INSTALL_LSP_TOOL \"basedpyright\" \"basedpyright\"\n        INSTALL_LSP_TOOL \"debugpy\" \"debugpy\"\n        INSTALL_LSP_TOOL \"ipython\" \"ipython\"\n        INSTALL_LSP_TOOL \"pdbpp\" \"pdbpp\"\n        ;;\nn | N) echo \"Skipping extra tooling.\" ;;\n*) echo \"Unknown selection, skipping.\" ;;\nesac\ncreate_xdg_config() {\n        tool=\"$1\"\n        default_content=\"$2\"\n        confdir=\"$XDG_CONFIG_HOME/$tool\"\n        confpath=\"$confdir/config.toml\"\n        mkdir -p \"$confdir\"\n        if [ -f \"$confpath\" ]; then\n                echo \"→ $tool config already exists at $confpath\"\n                return\n        fi\n        printf \"Do you want to write an example config for $tool to %s? [Y/n]: \" \"$confpath\"\n        read -r ans\n        [ -z \"$ans\" ] \u0026\u0026 ans=\"Y\"\n        if [ \"$ans\" = \"Y\" ] || [ \"$ans\" = \"y\" ]; then\n                echo \"→ Creating example $tool config at $confpath\"\n                printf \"%s\\n\" \"$default_content\" \u003e\"$confpath\"\n        fi\n}\nRUFF_CFG='[lint]\\nselect = [\"E\", \"F\", \"W\"] # Example: style, errors, warnings'\nUV_CFG='[uv]\\npypi_mirror = \"https://pypi.org/simple\"\\ncache_dir = \"~/.cache/uv\"\\n'\nPYTHON_CFG='[startup]\\n# Put any sitecustomize or startup hooks here\\n'\ncreate_xdg_config \"ruff\" \"$RUFF_CFG\"\ncreate_xdg_config \"uv\" \"$UV_CFG\"\ncreate_xdg_config \"python\" \"$PYTHON_CFG\"\necho\necho \"✅ Python $VERSIONS_TO_BUILD has been built and installed in $BIN_DIR\"\nif [ \"$FREE_THREADED\" = \"yes\" ]; then\n        echo \" (Free-threaded interpreter enabled!)\"\nfi\necho \"→ Test it with: $PYTHON_PATH --version\"\necho \"→ Your pip is: $PIP_PATH\"\necho \"→ pyenv (if installed) is in \\$HOME/.pyenv; add to your PATH if desired.\"\necho \"→ ruff and uv are installed in ~/.local/bin (and can be configured in $XDG_CONFIG_HOME/)\"\necho \"→ All binaries/libs/configs are under ~/.local/, ~/.pyenv/, ~/.config/\"\necho \"→ Add '$BIN_DIR' to your shell \\$PATH if not already present.\"\necho \"→ For custom packages, use: $PIP_PATH install --user ...\"\necho \"→ To uninstall, just rm -rf $LOCAL_PREFIX/{bin/lib/share} $SRC_DIR/cpython-* ~/.pyenv ~/.cache/ruff ~/.cache/uv $XDG_CONFIG_HOME/ruff $XDG_CONFIG_HOME/uv\"\necho \"─ Ready, Set, Python! ─\"\nexit 0 \u003c/pre\u003e\n\u003c/details\u003e \u003cp\u003eOr, \u003ca href=\"https://github.com/qompassai/python/blob/main/scripts/quickstart.sh\" target=\"_blank\"\u003eView\nthe quickstart script\u003c/a\u003e.\u003c/p\u003e\n \u003c/details\u003e\n\n  \u003c/blockquote\u003e\n  \u003c/details\u003e\n\n  \u003cdetails\u003e\n    \u003csummary\n      style=\"font-size: 1.4em; font-weight: bold; padding: 15px; background: #667eea; color: white; border-radius: 10px; cursor: pointer; margin: 10px 0;\"\u003e\n      \u003cstrong\u003e🧭 About Qompass AI\u003c/strong\u003e\n    \u003c/summary\u003e\n    \u003cblockquote\n      style=\"font-size: 1.2em; line-height: 1.8; padding: 25px; background: #f8f9fa; border-left: 6px solid #667eea; border-radius: 8px; margin: 15px 0; box-shadow: 0 2px 8px rgba(0,0,0,0.1);\"\u003e\n    \u003cdiv align=\"center\"\u003e\n    \u003cp\u003eMatthew A. Porter\u003cbr\u003e\n      Former Intelligence Officer\u003cbr\u003e\n      Educator \u0026 Learner\u003cbr\u003e\n      DeepTech Founder \u0026 CEO\u003c/p\u003e\n  \u003c/div\u003e\n\n  \u003ch3\u003ePublications\u003c/h3\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://orcid.org/0000-0002-0302-4812\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/ORCID-0000--0002--0302--4812-green?style=flat-square\u0026logo=orcid\"\n        alt=\"ORCID\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.researchgate.net/profile/Matt-Porter-7\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/ResearchGate-Open--Research-blue?style=flat-square\u0026logo=researchgate\"\n        alt=\"ResearchGate\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://zenodo.org/communities/qompassai\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Zenodo-Publications-blue?style=flat-square\u0026logo=zenodo\" alt=\"Zenodo\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003ch3\u003eDeveloper Programs\u003c/h3\u003e\n\n[![NVIDIA\nDeveloper](https://img.shields.io/badge/NVIDIA-Developer_Program-76B900?style=for-the-badge\\\u0026logo=nvidia\\\u0026logoColor=white)](https://developer.nvidia.com/)\n[![Meta\nDeveloper](https://img.shields.io/badge/Meta-Developer_Program-0668E1?style=for-the-badge\\\u0026logo=meta\\\u0026logoColor=white)](https://developers.facebook.com/)\n[![HackerOne](https://img.shields.io/badge/-HackerOne-%23494649?style=for-the-badge\\\u0026logo=hackerone\\\u0026logoColor=white)](https://hackerone.com/phaedrusflow)\n[![HuggingFace](https://img.shields.io/badge/HuggingFace-qompass-yellow?style=flat-square\\\u0026logo=huggingface)](https://huggingface.co/qompass)\n[![Epic Games\nDeveloper](https://img.shields.io/badge/Epic_Games-Developer_Program-313131?style=for-the-badge\\\u0026logo=epic-games\\\u0026logoColor=white)](https://dev.epicgames.com/)\n\n  \u003ch3\u003eProfessional Profiles\u003c/h3\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://www.linkedin.com/in/matt-a-porter-103535224/\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/LinkedIn-Matt--Porter-blue?style=flat-square\u0026logo=linkedin\"\n        alt=\"Personal LinkedIn\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.linkedin.com/company/95058568/\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/LinkedIn-Qompass--AI-blue?style=flat-square\u0026logo=linkedin\"\n        alt=\"Startup LinkedIn\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003ch3\u003eSocial Media\u003c/h3\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://twitter.com/PhaedrusFlow\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Twitter-@PhaedrusFlow-blue?style=flat-square\u0026logo=twitter\"\n        alt=\"X/Twitter\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.instagram.com/phaedrusflow\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Instagram-phaedrusflow-purple?style=flat-square\u0026logo=instagram\"\n        alt=\"Instagram\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://www.youtube.com/@qompassai\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/YouTube-QompassAI-red?style=flat-square\u0026logo=youtube\"\n        alt=\"Qompass AI YouTube\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\n\u003c/blockquote\u003e\n\n  \u003c/details\u003e\n\n  \u003cdetails\u003e\n    \u003csummary\n      style=\"font-size: 1.4em; font-weight: bold; padding: 15px; background: #ff6b6b; color: white; border-radius: 10px; cursor: pointer; margin: 10px 0;\"\u003e\n      \u003cstrong\u003e🔥 How Do I Support\u003c/strong\u003e\n    \u003c/summary\u003e\n    \u003cblockquote\n      style=\"font-size: 1.2em; line-height: 1.8; padding: 25px; background: #fff5f5; border-left: 6px solid #ff6b6b; border-radius: 8px; margin: 15px 0; box-shadow: 0 2px 8px rgba(0,0,0,0.1);\"\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003ctable\u003e\n      \u003ctr\u003e\n        \u003cth align=\"center\"\u003e🏛️ Qompass AI Pre-Seed Funding 2023-2025\u003c/th\u003e\n        \u003cth align=\"center\"\u003e🏆 Amount\u003c/th\u003e\n        \u003cth align=\"center\"\u003e📅 Date\u003c/th\u003e\n      \u003c/tr\u003e\n      \u003ctr\u003e\n        \u003ctd\u003e\u003ca href=\"https://github.com/qompassai/r4r\"\n            title=\"RJOS/Zimmer Biomet Research Grant Repository\"\u003eRJOS/Zimmer Biomet Research Grant\u003c/a\u003e\u003c/td\u003e\n        \u003ctd align=\"center\"\u003e$30,000\u003c/td\u003e\n        \u003ctd align=\"center\"\u003eMarch 2024\u003c/td\u003e\n      \u003c/tr\u003e\n      \u003ctr\u003e\n        \u003ctd\u003e\u003ca href=\"https://github.com/qompassai/PathFinders\" title=\"GitHub Repository\"\u003ePathfinders Intern\n            Program\u003c/a\u003e\u003cbr\u003e\n          \u003csmall\u003e\u003ca\n              href=\"https://www.linkedin.com/posts/evergreenbio_bioscience-internships-workforcedevelopment-activity-7253166461416812544-uWUM/\"\n              target=\"_blank\"\u003eView on LinkedIn\u003c/a\u003e\u003c/small\u003e\n        \u003c/td\u003e\n        \u003ctd align=\"center\"\u003e$2,000\u003c/td\u003e\n        \u003ctd align=\"center\"\u003eOctober 2024\u003c/td\u003e\n      \u003c/tr\u003e\n    \u003c/table\u003e\n    \u003cbr\u003e\n    \u003ch4\u003e🤝 How To Support Our Mission\u003c/h4\u003e\n    [![GitHub\n    Sponsors](https://img.shields.io/badge/GitHub-Sponsor-EA4AAA?style=for-the-badge\\\u0026logo=github-sponsors\\\u0026logoColor=white)](https://github.com/sponsors/phaedrusflow)\n    [![Patreon](https://img.shields.io/badge/Patreon-Support-F96854?style=for-the-badge\\\u0026logo=patreon\\\u0026logoColor=white)](https://patreon.com/qompassai)\n    [![Liberapay](https://img.shields.io/badge/Liberapay-Donate-F6C915?style=for-the-badge\\\u0026logo=liberapay\\\u0026logoColor=black)](https://liberapay.com/qompassai)\n    [![Open\n    Collective](https://img.shields.io/badge/Open%20Collective-Support-7FADF2?style=for-the-badge\\\u0026logo=opencollective\\\u0026logoColor=white)](https://opencollective.com/qompassai)\n    [![Buy Me A\n    Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-FFDD00?style=for-the-badge\\\u0026logo=buy-me-a-coffee\\\u0026logoColor=black)](https://www.buymeacoffee.com/phaedrusflow)\n    \u003cdetails markdown=\"1\"\u003e\n      \u003csummary\u003e\u003cstrong\u003e🔐 Cryptocurrency Donations\u003c/strong\u003e\u003c/summary\u003e\n      **Monero (XMR):**\n      \u003cdiv align=\"center\"\u003e\n        \u003cimg src=\"https://github.com/qompassai/svg/assets/monero-qr.svg\" alt=\"Monero QR Code\" width=\"180\"\u003e\n      \u003c/div\u003e\n  \u003cdiv style=\"margin: 10px 0;\"\u003e\n    \u003ccode\u003e42HGspSFJQ4MjM5ZusAiKZj9JZWhfNgVraKb1eGCsHoC6QJqpo2ERCBZDhhKfByVjECernQ6KeZwFcnq8hVwTTnD8v4PzyH\u003c/code\u003e\n  \u003c/div\u003e\n\n\u003cbutton\nonclick=\"navigator.clipboard.writeText('42HGspSFJQ4MjM5ZusAiKZj9JZWhfNgVraKb1eGCsHoC6QJqpo2ERCBZDhhKfByVjECernQ6KeZwFcnq8hVwTTnD8v4PzyH')\"\nstyle=\"padding: 6px 12px; background: #FF6600; color: white; border: none; border-radius: 4px; cursor: pointer;\"\u003e\n📋 Copy Address \u003c/button\u003e\n\n  \u003cp\u003e\u003ci\u003eFunding helps us continue our research at the intersection of AI, healthcare, and education\u003c/i\u003e\u003c/p\u003e\n\n\u003c/blockquote\u003e\n\n  \u003c/details\u003e\n  \u003c/details\u003e\n\n  \u003cdetails id=\"FAQ\"\u003e\n    \u003csummary\u003e\u003cstrong\u003eFrequently Asked Questions\u003c/strong\u003e\u003c/summary\u003e\n### Q: How do you mitigate against bias?\n\n**TLDR - we do math to make AI ethically useful**\n\n### A: We delineate between mathematical bias (MB) - a fundamental parameter in neural network equations - and\n\nalgorithmic/social bias (ASB). While MB is optimized during model training through backpropagation, ASB requires\ncareful consideration of data sources, model architecture, and deployment strategies. We implement attention\nmechanisms for improved input processing and use legal open-source data and secure web-search APIs to help mitigate\nASB.\n\n[AAMC AI Guidelines | One way to align AI against\nASB](https://www.aamc.org/about-us/mission-areas/medical-education/principles-ai-use)\n\n### AI Math at a glance\n\n## Forward Propagation Algorithm\n\n$$\ny = w\\_1x\\_1 + w\\_2x\\_2 + ... + w\\_nx\\_n + b\n$$\n\nWhere:\n\n* $y$ represents the model output\n* $(x\\_1, x\\_2, ..., x\\_n)$ are input features\n* $(w\\_1, w\\_2, ..., w\\_n)$ are feature weights\n* $b$ is the bias term\n\n### Neural Network Activation\n\nFor neural networks, the bias term is incorporated before activation:\n\n$$\nz = \\sum\\_{i=1}^{n} w\\_ix\\_i + b\n$$\n$$\na = \\sigma(z)\n$$\n\nWhere:\n\n* $z$ is the weighted sum plus bias\n* $a$ is the activation output\n* $\\sigma$ is the activation function\n\n### Attention Mechanism- aka what makes the Transformer (The \"T\" in ChatGPT) powerful\n\n* [Attention High level overview video](https://www.youtube.com/watch?v=fjJOgb-E41w)\n\n* [Attention Is All You Need Arxiv Paper](https://arxiv.org/abs/1706.03762)\n\nThe Attention mechanism equation is:\n\n$$\n\\text{Attention}(Q, K, V) = \\text{softmax}\\left( \\frac{QK^T}{\\sqrt{d\\_k}} \\right) V\n$$\n\nWhere:\n\n* $Q$ represents the Query matrix\n* $K$ represents the Key matrix\n* $V$ represents the Value matrix\n* $d\\_k$ is the dimension of the key vectors\n* $\\text{softmax}(\\cdot)$ normalizes scores to sum to 1\n\n### Q: Do I have to buy a Linux computer to use this? I don't have time for that!\n\n### A: No. You can run Linux and/or the tools we share alongside your existing operating system:\n\n* Windows users can use Windows Subsystem for Linux [WSL](https://learn.microsoft.com/en-us/windows/wsl/install)\n* Mac users can use [Homebrew](https://brew.sh/)\n* The code-base instructions were developed with both beginners and advanced users in mind.\n\n### Q: Do you have to get a masters in AI?\n\n### A: Not if you don't want to. To get competent enough to get past ChatGPT dependence at least, you just need a\n\ncomputer and a beginning's mindset. Huggingface is a good place to start.\n\n* [Huggingface](https://docs.google.com/presentation/d/1IkzESdOwdmwvPxIELYJi8--K3EZ98_cL6c5ZcLKSyVg/edit#slide=id.p)\n\n### Q: What makes a \"small\" AI model?\n\n### A: AI models ~=10 billion(10B) parameters and below. For comparison, OpenAI's GPT4o contains approximately 200B parameters.\n\n  \u003c/details\u003e\n\n  \u003cdetails id=\"Dual-License Notice\"\u003e\n    \u003csummary\u003e\u003cstrong\u003eWhat a Dual-License Means\u003c/strong\u003e\u003c/summary\u003e\n\n### Protection for Vulnerable Populations\n\nThe dual licensing aims to address the cybersecurity gap that disproportionately affects underserved populations. As\nhighlighted by recent attacks\u003csup\u003e\u003ca href=\"#ref1\"\u003e\\[1]\u003c/a\u003e\u003c/sup\u003e, low-income residents, seniors, and foreign language\nspeakers face higher-than-average risks of being victims of cyberattacks. By offering both open-source and\ncommercial licensing options, we encourage the development of cybersecurity solutions that can reach these\nvulnerable groups while also enabling sustainable development and support.\n\n### Preventing Malicious Use\n\nThe AGPL-3.0 license ensures that any modifications to the software remain open source, preventing bad actors from\ncreating closed-source variants that could be used for exploitation. This is especially crucial given the rising\nthreats to vulnerable communities, including children in educational settings. The attack on Minneapolis Public\nSchools, which resulted in the leak of 300,000 files and a $1 million ransom demand, highlights the importance of\ntransparency and security\u003csup\u003e\u003ca href=\"#ref8\"\u003e\\[8]\u003c/a\u003e\u003c/sup\u003e.\n\n### Addressing Cybersecurity in Critical Sectors\n\nThe commercial license option allows for tailored solutions in critical sectors such as healthcare, which has seen\nsignificant impacts from cyberattacks. For example, the recent Change Healthcare attack\u003csup\u003e\u003ca\nhref=\"#ref4\"\u003e\\[4]\u003c/a\u003e\u003c/sup\u003e affected millions of Americans and caused widespread disruption for hospitals and\nother providers. In January 2025, CISA\u003csup\u003e\u003ca href=\"#ref2\"\u003e\\[2]\u003c/a\u003e\u003c/sup\u003e and FDA\u003csup\u003e\u003ca href=\"#ref3\"\u003e\\[3]\u003c/a\u003e\u003c/sup\u003e\njointly warned of critical backdoor vulnerabilities in Contec CMS8000 patient monitors, revealing how medical\ndevices could be compromised for unauthorized remote access and patient data manipulation.\n\n### Supporting Cybersecurity Awareness\n\nThe dual licensing model supports initiatives like the Cybersecurity and Infrastructure Security Agency (CISA)\nefforts to improve cybersecurity awareness\u003csup\u003e\u003ca href=\"#ref7\"\u003e\\[7]\u003c/a\u003e\u003c/sup\u003e in \"target rich\" sectors, including\nK-12 education\u003csup\u003e\u003ca href=\"#ref5\"\u003e\\[5]\u003c/a\u003e\u003c/sup\u003e. By allowing both open-source and commercial use, we aim to\nfacilitate the development of tools that support these critical awareness and protection efforts.\n\n### Bridging the Digital Divide\n\nThe unfortunate reality is that too many individuals and organizations have gone into a frenzy in every facet of our\ndaily lives\u003csup\u003e\u003ca href=\"#ref6\"\u003e\\[6]\u003c/a\u003e\u003c/sup\u003e. These unfortunate folks identify themselves with their talk of \"10X\"\nreturns and building towards Artificial General Intelligence aka \"AGI\" while offering GPT wrappers. Our dual\nlicensing approach aims to acknowledge this deeply concerning predatory paradigm with clear eyes while still\noperating to bring the best parts of the open-source community with our services and solutions.\n\n### Recent Cybersecurity Attacks\n\nRecent attacks underscore the importance of robust cybersecurity measures:\n\n* The Change Healthcare cyberattack in February 2024 affected millions of Americans and caused significant\n  disruption to healthcare providers.\n* The White House and Congress jointly designated October 2024 as Cybersecurity Awareness Month. This designation\n  comes with over 100 actions that align the Federal government and public/private sector partners are taking to help\n  every man, woman, and child to safely navigate the age of AI.\n\nBy offering both open source and commercial licensing options, we strive to create a balance that promotes\ninnovation and accessibility. We address the complex cybersecurity challenges faced by vulnerable populations and\ncritical infrastructure sectors as the foundation of our solutions, not an afterthought.\n\n### References\n\n\u003cdiv id=\"footnotes\"\u003e\n  \u003cp id=\"ref1\"\u003e\u003cstrong\u003e[1]\u003c/strong\u003e \u003ca\n      href=\"https://www.whitehouse.gov/briefing-room/statements-releases/2024/10/02/international-counter-ransomware-initiative-2024-joint-statement/\"\u003eInternational\n      Counter Ransomware Initiative 2024 Joint Statement\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref2\"\u003e\u003cstrong\u003e[2]\u003c/strong\u003e \u003ca\n      href=\"https://www.cisa.gov/sites/default/files/2025-01/fact-sheet-contec-cms8000-contains-a-backdoor-508c.pdf\"\u003eContec\n      CMS8000 Contains a Backdoor\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref3\"\u003e\u003cstrong\u003e[3]\u003c/strong\u003e \u003ca\n      href=\"https://www.aha.org/news/headline/2025-01-31-cisa-fda-warn-vulnerabilities-contec-patient-monitors\"\u003eCISA,\n      FDA warn of vulnerabilities in Contec patient monitors\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref4\"\u003e\u003cstrong\u003e[4]\u003c/strong\u003e \u003ca\n      href=\"https://www.chiefhealthcareexecutive.com/view/the-top-10-health-data-breaches-of-the-first-half-of-2024\"\u003eThe\n      Top 10 Health Data Breaches of the First Half of 2024\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref5\"\u003e\u003cstrong\u003e[5]\u003c/strong\u003e \u003ca href=\"https://www.cisa.gov/K12Cybersecurity\"\u003eCISA's K-12 Cybersecurity\n      Initiatives\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref6\"\u003e\u003cstrong\u003e[6]\u003c/strong\u003e \u003ca\n      href=\"https://www.ftc.gov/business-guidance/blog/2024/09/operation-ai-comply-continuing-crackdown-overpromises-ai-related-lies\"\u003eFederal\n      Trade Commission Operation AI Comply: continuing the crackdown on overpromises and AI-related lies\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref7\"\u003e\u003cstrong\u003e[7]\u003c/strong\u003e \u003ca\n      href=\"https://www.whitehouse.gov/briefing-room/presidential-actions/2024/09/30/a-proclamation-on-cybersecurity-awareness-month-2024/\"\u003eA\n      Proclamation on Cybersecurity Awareness Month, 2024\u003c/a\u003e\u003c/p\u003e\n\n  \u003cp id=\"ref8\"\u003e\u003cstrong\u003e[8]\u003c/strong\u003e \u003ca\n      href=\"https://therecord.media/minneapolis-schools-say-data-breach-affected-100000/\"\u003eMinneapolis school\n      district says data breach affected more than 100,000 people\u003c/a\u003e\u003c/p\u003e\n\u003c/div\u003e\n  \u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqompassai%2Fpython","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqompassai%2Fpython","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqompassai%2Fpython/lists"}