{"id":33609462,"url":"https://github.com/smart-ai-memory/empathy-framework","last_synced_at":"2026-02-01T07:18:36.949Z","repository":{"id":323171371,"uuid":"1092404365","full_name":"Smart-AI-Memory/empathy-framework","owner":"Smart-AI-Memory","description":"Combining a five-level AI framework with git-native memory overcomes session amnesia, enabling anticipation of problems weeks early. Production results: 2000x cost reduction, 10x+ productivity, shifting AI from reactive to predictive partnership through emotional intelligence, tactical empathy, and systems thinking.","archived":false,"fork":false,"pushed_at":"2026-01-17T08:41:48.000Z","size":47912,"stargazers_count":9,"open_issues_count":18,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-18T12:26:51.686Z","etag":null,"topics":["ai","ai-collaboration","anthropic","anticipatory-ai","artificial-intelligence","claude-code","code-analysis","debugging","developer-productivity","developer-tools","developer-tools-monorepo","fair-source","framework","healthcare-ai","large-language-models","llm","memdocs","open-source","python","testing"],"latest_commit_sha":null,"homepage":"https://smartaimemory.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Smart-AI-Memory.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["silversurfer562"],"custom":["https://smartaimemory.com","mailto:admin@smartaimemory.com?subject=Empathy%20Framework%20Support"]}},"created_at":"2025-11-08T15:11:44.000Z","updated_at":"2026-01-13T03:57:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Smart-AI-Memory/empathy-framework","commit_stats":null,"previous_names":["smart-ai-memory/empathy","smart-ai-memory/empathy-framework"],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/Smart-AI-Memory/empathy-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Smart-AI-Memory%2Fempathy-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Smart-AI-Memory%2Fempathy-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Smart-AI-Memory%2Fempathy-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Smart-AI-Memory%2Fempathy-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Smart-AI-Memory","download_url":"https://codeload.github.com/Smart-AI-Memory/empathy-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Smart-AI-Memory%2Fempathy-framework/sbom","scorecard":{"id":1240145,"data":{"date":"2025-12-01T19:50:36Z","repo":{"name":"github.com/Smart-AI-Memory/empathy-framework","commit":"f908aa715b3eb032f9fc3c853dfa98054fd30ebe"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":3.4,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/26 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yml:13","Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecard.yml:36","Info: jobLevel 'actions' permission set to 'read': .github/workflows/scorecard.yml:38","Warn: jobLevel 'security-events' permission set to 'write': .github/workflows/security.yml:17","Info: jobLevel 'contents' permission set to 'read': .github/workflows/security.yml:18","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:13","Warn: topLevel 'security-events' permission set to 'write': .github/workflows/codeql.yml:14","Info: topLevel 'actions' permission set to 'read': .github/workflows/codeql.yml:15","Warn: no topLevel permission defined: .github/workflows/pre-commit.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:23","Warn: no topLevel permission defined: .github/workflows/security.yml:1","Warn: no topLevel permission defined: .github/workflows/tests.yml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":7,"reason":"binaries present in source code","details":["Warn: binary detected: examples/wizard-dashboard/node_modules/@esbuild/darwin-arm64/bin/esbuild:1","Warn: binary detected: examples/wizard-dashboard/node_modules/@rollup/rollup-darwin-arm64/rollup.darwin-arm64.node:1","Warn: binary detected: examples/wizard-dashboard/node_modules/esbuild/bin/esbuild:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/codeql.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/codeql.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/codeql.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/codeql.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pre-commit.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/pre-commit.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pre-commit.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/pre-commit.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/scorecard.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/scorecard.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/scorecard.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/scorecard.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/security.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/security.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/security.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/security.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/security.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/security.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/security.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/security.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/tests.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:79: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:82: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:98: update your workflow using https://app.stepsecurity.io/secureworkflow/Smart-AI-Memory/empathy-framework/tests.yml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:2: pin your Docker image by updating node:20-slim to node:20-slim@sha256:fbb357f69d05c97333855b0846e4ef65462409728312df3c9ff12c941741c0a5","Warn: containerImage not pinned by hash: Dockerfile.scanner:5: pin your Docker image by updating python:3.11-slim to python:3.11-slim@sha256:193fdd0bbcb3d2ae612bd6cc3548d2f7c78d65b549fcaa8af75624c47474444d","Warn: pipCommand not pinned by hash: Dockerfile.scanner:22-23","Warn: pipCommand not pinned by hash: install.sh:29","Warn: pipCommand not pinned by hash: .github/workflows/pre-commit.yml:21","Warn: pipCommand not pinned by hash: .github/workflows/release.yml:28","Warn: pipCommand not pinned by hash: .github/workflows/release.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/security.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/security.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:30","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:31","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:63","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:64","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:88","Warn: pipCommand not pinned by hash: .github/workflows/tests.yml:89","Info:   0 out of  22 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   2 containerImage dependencies pinned","Info:   1 out of   1 npmCommand dependencies pinned","Info:   0 out of  13 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: all commits (5) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Dependency-Update-Tool","score":0,"reason":"no update tool detected","details":["Warn: no dependency update tool configurations found"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Vulnerabilities","score":0,"reason":"27 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-38 / GHSA-2jv5-9r88-3w3p","Warn: Project is vulnerable to: PYSEC-2024-232 / GHSA-6c5p-j8vq-pqhj","Warn: Project is vulnerable to: PYSEC-2024-233 / GHSA-cjwg-qfpm-7377","Warn: Project is vulnerable to: GHSA-59g5-xgcq-4qw3","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-ww39-953v-wcq6","Warn: Project is vulnerable to: GHSA-mh29-5h37-fv8m","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55","Warn: Project is vulnerable to: GHSA-qrpm-p2h7-hrv2","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm","Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99","Warn: Project is vulnerable to: PYSEC-2021-47 / GHSA-5jqp-qgf6-3pvh","Warn: Project is vulnerable to: GHSA-mr82-8j83-vxmv","Warn: Project is vulnerable to: GHSA-29xp-372q-xqph"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":3,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'main'","Info: 'force pushes' disabled on branch 'main'","Warn: 'branch protection settings apply to administrators' is disabled on branch 'main'","Warn: 'stale review dismissal' is disabled on branch 'main'","Warn: branch 'main' does not require approvers","Warn: codeowners review is not required on branch 'main'","Warn: 'last push approval' is disabled on branch 'main'","Warn: 'up-to-date branches' is disabled on branch 'main'","Info: status check found to merge onto on branch 'main'","Info: PRs are required in order to make changes on branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.9.5 not signed: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/266361384","Warn: release artifact v1.9.4 not signed: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/266207401","Warn: release artifact v1.7.1 not signed: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/264506796","Warn: release artifact v1.7.0 not signed: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/264504483","Warn: release artifact v1.6.8 not signed: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/264493365","Warn: release artifact v1.9.5 does not have provenance: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/266361384","Warn: release artifact v1.9.4 does not have provenance: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/266207401","Warn: release artifact v1.7.1 does not have provenance: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/264506796","Warn: release artifact v1.7.0 does not have provenance: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/264504483","Warn: release artifact v1.6.8 does not have provenance: https://api.github.com/repos/Smart-AI-Memory/empathy-framework/releases/264493365"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Contributors","score":6,"reason":"project has 2 contributing companies or organizations -- score normalized to 6","details":["Info: found contributions from: Smart-AI-Memory, smartai memory"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"CI-Tests","score":10,"reason":"1 out of 1 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}}]},"last_synced_at":"2025-12-02T16:58:35.597Z","repository_id":323171371,"created_at":"2025-12-02T16:58:35.597Z","updated_at":"2025-12-02T16:58:35.597Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28605916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T14:45:23.139Z","status":"ssl_error","status_checked_at":"2026-01-20T14:44:16.929Z","response_time":117,"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","ai-collaboration","anthropic","anticipatory-ai","artificial-intelligence","claude-code","code-analysis","debugging","developer-productivity","developer-tools","developer-tools-monorepo","fair-source","framework","healthcare-ai","large-language-models","llm","memdocs","open-source","python","testing"],"created_at":"2025-11-30T19:03:06.762Z","updated_at":"2026-02-01T07:18:36.942Z","avatar_url":"https://github.com/Smart-AI-Memory.png","language":"HTML","funding_links":["https://github.com/sponsors/silversurfer562","https://smartaimemory.com","mailto:admin@smartaimemory.com?subject=Empathy%20Framework%20Support"],"categories":[],"sub_categories":[],"readme":"# Empathy Framework\n\n**AI-powered developer workflows with cost optimization and pattern learning.**\n\nRun code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.\n\n[![PyPI](https://img.shields.io/pypi/v/empathy-framework?color=blue)](https://pypi.org/project/empathy-framework/)\n[![Tests](https://img.shields.io/badge/tests-7%2C168%20passing%20(99.9%25)-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)\n[![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)\n[![Performance](https://img.shields.io/badge/performance-18x%20faster-success)](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/CHANGELOG.md)\n\n```bash\npip install empathy-framework[developer]\n```\n\n---\n\n## 🎯 Transitioning to Claude-Native Architecture\n\n**Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:\n\n- **📦 Prompt Caching:** 90% cost reduction on repeated prompts\n- **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases\n- **🧠 Extended Thinking:** See Claude's internal reasoning process\n- **🔧 Advanced Tool Use:** Optimized for agentic workflows\n\n**Timeline:**\n\n- ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers\n- ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)\n- ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring\n\n**Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)\n\n---\n\n## What's New in v5.3.0\n\n**🎨 Dashboard Enhancements** - Improved usability and clarity:\n\n- **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., \"Code Analyzer\" instead of UUID)\n- **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup\n- **UX Improvements** - \"Source Agent:\" label clarity, \"Redis Requires Enabling\" status message\n- **Browser Cache Busting** - Date-based versioning ensures updates appear immediately\n\n**📚 Documentation Improvements**:\n\n- Clarified flexible context strategy (200K subscription + 1M API routing)\n- Added Redis requirement documentation for dashboard\n- Root directory cleanup (8 archived files)\n\n**🧪 Test Infrastructure**:\n\n- Sequential test execution to fix import timing issues\n- All agent tracking tests passing (19/19)\n\n[See Full Changelog](CHANGELOG.md#530---2026-01-31)\n\n---\n\n## What's New in v5.1.0\n\n**🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:\n\n- **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:\n  - Agent heartbeats and status tracking\n  - Inter-agent coordination signals\n  - Event streaming across agent workflows\n  - Approval gates for human-in-the-loop\n  - Quality feedback and performance metrics\n  - Demo mode with test data generation\n\n- **Custom Agents** - Build specialized agents for your workflow needs\n- **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities\n- Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**\n\n**🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:\n\n```bash\n# Interactive setup\npython -m empathy_os.models.auth_cli setup\n\n# View current configuration\npython -m empathy_os.models.auth_cli status\n\n# Get recommendation for a file\npython -m empathy_os.models.auth_cli recommend src/module.py\n```\n\n**💰 Automatic Cost Optimization** - Workflows choose the best auth method:\n\n- Small/medium modules (\u003c2000 LOC) → Claude subscription (free)\n- Large modules (\u003e2000 LOC) → Anthropic API (pay for what you need)\n- 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep\n- Auth mode tracking in all workflow outputs for telemetry\n\n**🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:\n\n- All workflows tested with auth enabled/disabled\n- API and subscription mode verification\n- Cost tracking validation\n\n**📖 Documentation** - 950+ lines across 3 guides:\n\n- [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration\n- [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference\n- [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns\n\n[See Full Changelog](CHANGELOG.md#510---2026-01-29)\n\n---\n\n## What's New in v5.0.2\n\n**💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:\n\n```bash\nempathy batch submit batch_requests.json  # Submit batch job\nempathy batch status msgbatch_abc123      # Check progress\nempathy batch results msgbatch_abc123 output.json  # Download results\n```\n\nPerfect for: log analysis, report generation, bulk classification, test generation\n\n**📊 Precise Token Counting** - \u003e98% accurate cost tracking:\n\n- Integrated Anthropic's `count_tokens()` API for billing-accurate measurements\n- 3-tier fallback: API → tiktoken (local) → heuristic\n- Cache-aware cost calculation (25% write markup, 90% read discount)\n\n**📈 Cache Performance Monitoring** - Track your 20-30% caching savings:\n\n```bash\nempathy cache stats           # Show hit rates and cost savings\nempathy cache stats --verbose # Detailed token metrics\nempathy cache stats --format json  # Machine-readable output\n```\n\n**🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:\n\n```bash\nempathy routing stats \u003cworkflow\u003e    # Performance metrics\nempathy routing check --all         # Tier upgrade recommendations\nempathy routing models --provider anthropic  # Compare models\n```\n\n**🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:\n- Agent heartbeats displaying correctly\n- Event streaming functional\n- Coordination signals working\n- Approval gates operational\n\n[See Full Changelog](CHANGELOG.md#502---2026-01-28) | [Batch API Guide](docs/BATCH_API_GUIDE.md) | [User API Docs](docs/USER_API_DOCUMENTATION.md)\n\n---\n\n## What's New in v4.9.0\n\n**⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:\n\n- **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)\n- **Generator Expressions:** 99.9% memory reduction across 27 optimizations\n- **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)\n- **Incremental Scanning:** Git diff-based updates (10x faster)\n\n**🧭 Natural Language Workflows** - Use plain English instead of workflow names:\n\n```bash\n/workflows \"find security vulnerabilities\"  # → security-audit\n/workflows \"check code performance\"         # → perf-audit\n/workflows \"predict bugs\"                   # → bug-predict\n/plan \"review my code\"                      # → code-review\n```\n\n**📊 Real-World Performance:**\n\n- Combined workflow: 3.59s → 0.2s (**18x faster**)\n- Full scan: 3,472 files in 0.98s (was 3.59s)\n- Redis cached operations: 37ms → 0.001ms\n\n**🎯 Improved Navigation:**\n\n- Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)\n- Clearer hub organization with better categorization\n- Natural language routing matches intent to workflow\n\n[See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)\n\n---\n\n## What's New in v4.7.0\n\n**$0 Workflows via Skills** - Multi-agent workflows run through Claude Code's Task tool instead of API calls. No additional cost with your Claude subscription.\n\n**Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.\n\n**Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).\n\n**Hub-Based Commands** - Organized workflows into intuitive command hubs.\n\n---\n\n## Quick Start\n\n### 1. Install\n\n```bash\npip install empathy-framework[developer]\n```\n\n### 2. Configure\n\n```bash\n# Auto-detect API keys\npython -m empathy_os.models.cli provider\n\n# Or set explicitly\npython -m empathy_os.models.cli provider --set anthropic\n```\n\n### 3. Use\n\n**In Claude Code:**\n\n```bash\n/dev           # Developer tools (debug, commit, PR, review)\n/testing       # Run tests, coverage, benchmarks\n/workflows     # Automated analysis (security, bugs, perf)\n/plan          # Planning, TDD, code review\n/docs          # Documentation generation\n/release       # Release preparation\n\n# Natural language support:\n/workflows \"find security issues\"\n/plan \"review my code\"\n\n# Direct tool access via MCP (v5.1.1+):\n# Claude Code automatically discovers Empathy tools through the MCP server\n# Just describe what you need in natural language:\n\"Run a security audit on src/\"          → Invokes security_audit tool\n\"Generate tests for config.py\"          → Invokes test_generation tool\n\"Check my auth configuration\"           → Invokes auth_status tool\n\"Analyze performance bottlenecks\"       → Invokes performance_audit tool\n```\n\n**MCP Server Integration (v5.1.1+):**\n\nEmpathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:\n\n- **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status\n- **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`\n- **Natural Language Access:** Describe your need and Claude invokes the appropriate tool\n- **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs\n\nTo verify MCP integration:\n\n```bash\n# Check server is running\necho '{\"method\":\"tools/list\",\"params\":{}}' | PYTHONPATH=./src python -m empathy_os.mcp.server\n\n# Restart Claude Code to load the MCP server\n# Tools will appear in Claude's tool list automatically\n```\n\nSee [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.\n\n**CLI:**\n\n```bash\nempathy workflow run security-audit --path ./src\nempathy workflow run test-coverage --target 90\nempathy telemetry show  # View cost savings\n```\n\n**Python:**\n\n```python\nfrom empathy_os import EmpathyOS\n\nasync with EmpathyOS() as empathy:\n    result = await empathy.level_2_guided(\n        \"Review this code for security issues\"\n    )\n    print(result[\"response\"])\n```\n\n---\n\n## Command Hubs\n\nWorkflows are organized into hubs for easy discovery:\n\n| Hub               | Command       | Description                                  |\n| ----------------- | ------------- | -------------------------------------------- |\n| **Developer**     | `/dev`        | Debug, commit, PR, code review, quality      |\n| **Testing**       | `/testing`    | Run tests, coverage analysis, benchmarks     |\n| **Documentation** | `/docs`       | Generate and manage documentation            |\n| **Release**       | `/release`    | Release prep, security scan, publishing      |\n| **Workflows**     | `/workflows`  | Automated analysis (security, bugs, perf)    |\n| **Plan**          | `/plan`       | Planning, TDD, code review, refactoring      |\n| **Utilities**     | `/utilities`  | Project init, dependencies, profiling        |\n| **Learning**      | `/learning`   | Pattern learning and session evaluation      |\n| **Context**       | `/context`    | State management and memory                  |\n| **Agent**         | `/agent`      | Create and manage custom agents              |\n\n**Natural Language Support:**\n\n```bash\n# Use plain English - intelligent routing matches your intent\n/workflows \"find security vulnerabilities\"  # → security-audit\n/workflows \"check code performance\"         # → perf-audit\n/workflows \"predict bugs\"                   # → bug-predict\n/plan \"review my code\"                      # → code-review\n/plan \"help me plan this feature\"           # → planning\n\n# Or use traditional workflow names\n/workflows security-audit\n/plan code-review\n```\n\n**Interactive menus:**\n\n```bash\n/dev                    # Show interactive menu\n/dev \"debug auth error\" # Jump directly to debugging\n/testing \"run coverage\" # Run coverage analysis\n/release                # Start release preparation\n```\n\n---\n\n## Socratic Method\n\nWorkflows guide you through discovery instead of requiring upfront configuration:\n\n```text\nYou: /dev\n\nClaude: What development task do you need?\n  1. Debug issue\n  2. Create commit\n  3. PR workflow\n  4. Quality check\n\nYou: 1\n\nClaude: What error or unexpected behavior are you seeing?\n```\n\n**How it works:**\n\n1. **Discovery** - Workflow asks targeted questions to understand your needs\n2. **Context gathering** - Collects relevant code, errors, and constraints\n3. **Dynamic agent creation** - Assembles the right team based on your answers\n4. **Execution** - Runs with appropriate tier selection\n\n**Create custom agents with Socratic guidance:**\n\n```bash\n/agent create    # Guided agent creation\n/agent team      # Build multi-agent teams interactively\n```\n\n---\n\n## Cost Optimization\n\n### Skills = $0 (Claude Code)\n\nWhen using Claude Code, workflows run as skills through the Task tool - **no API costs**:\n\n```bash\n/dev           # $0 - uses your Claude subscription\n/testing       # $0\n/release       # $0\n/agent create  # $0\n```\n\n### API Mode (CI/CD, Automation)\n\nFor programmatic use, smart tier routing saves 34-86%:\n\n| Tier    | Model               | Use Case                    | Cost        |\n| ------- | ------------------- | --------------------------- | ----------- |\n| CHEAP   | Haiku / GPT-4o-mini | Formatting, simple tasks    | ~$0.005     |\n| CAPABLE | Sonnet / GPT-4o     | Bug fixes, code review      | ~$0.08      |\n| PREMIUM | Opus / o1           | Architecture, complex design | ~$0.45      |\n\n```bash\n# Track API usage and savings\nempathy telemetry savings --days 30\n```\n\n---\n\n## Key Features\n\n### Multi-Agent Workflows\n\n```bash\n# 4 parallel agents check release readiness\nempathy orchestrate release-prep\n\n# Sequential coverage improvement\nempathy orchestrate test-coverage --target 90\n```\n\n### Response Caching\n\nUp to 57% cache hit rate on similar prompts. Zero config needed.\n\n```python\nfrom empathy_os.workflows import SecurityAuditWorkflow\n\nworkflow = SecurityAuditWorkflow(enable_cache=True)\nresult = await workflow.execute(target_path=\"./src\")\nprint(f\"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%\")\n```\n\n### Pattern Learning\n\nWorkflows learn from outcomes and improve over time:\n\n```python\nfrom empathy_os.orchestration.config_store import ConfigurationStore\n\nstore = ConfigurationStore()\nbest = store.get_best_for_task(\"release_prep\")\nprint(f\"Success rate: {best.success_rate:.1%}\")\n```\n\n### Multi-Provider Support\n\n```python\nfrom empathy_llm_toolkit.providers import (\n    AnthropicProvider,  # Claude\n    OpenAIProvider,     # GPT-4\n    GeminiProvider,     # Gemini\n    LocalProvider,      # Ollama, LM Studio\n)\n```\n\n---\n\n## CLI Reference\n\n```bash\n# Provider configuration\npython -m empathy_os.models.cli provider\npython -m empathy_os.models.cli provider --set hybrid\n\n# Workflows\nempathy workflow list\nempathy workflow run \u003cworkflow-name\u003e\n\n# Cost tracking\nempathy telemetry show\nempathy telemetry savings --days 30\nempathy telemetry export --format csv\n\n# Orchestration\nempathy orchestrate release-prep\nempathy orchestrate test-coverage --target 90\n\n# Meta-workflows\nempathy meta-workflow list\nempathy meta-workflow run release-prep --real\n```\n\n---\n\n## Install Options\n\n```bash\n# Individual developers (recommended)\npip install empathy-framework[developer]\n\n# All LLM providers\npip install empathy-framework[llm]\n\n# With caching (semantic similarity)\npip install empathy-framework[cache]\n\n# Enterprise (auth, rate limiting)\npip install empathy-framework[enterprise]\n\n# Healthcare (HIPAA compliance)\npip install empathy-framework[healthcare]\n\n# Development\ngit clone https://github.com/Smart-AI-Memory/empathy-framework.git\ncd empathy-framework \u0026\u0026 pip install -e .[dev]\n```\n\n---\n\n## Environment Setup\n\n```bash\n# At least one provider required\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\nexport OPENAI_API_KEY=\"sk-...\"\nexport GOOGLE_API_KEY=\"...\"\n\n# Optional (but required for Agent Dashboard): Redis for memory\nexport REDIS_URL=\"redis://localhost:6379\"\n```\n\n---\n\n## VSCode Extension\n\nInstall the Empathy VSCode extension for:\n\n- **Dashboard** - Health score, costs, patterns\n- **One-Click Workflows** - Run from command palette\n- **Memory Panel** - Manage Redis and patterns\n- **Cost Tracking** - Real-time savings display\n\n---\n\n## Documentation\n\n- [Quick Start Guide](docs/quickstart.md)\n- [CLI Reference](docs/cli-reference.md)\n- [Testing Guide](docs/testing-guide.md)\n- [Keyboard Shortcuts](docs/keyboard-shortcuts.md)\n- [Full Documentation](https://smartaimemory.com/framework-docs/)\n\n---\n\n## Security\n\n- Path traversal protection on all file operations\n- JWT authentication with rate limiting\n- PII scrubbing in telemetry\n- HIPAA/GDPR compliance options\n- **Automated security scanning** with 82% accuracy (Phase 3 AST-based detection)\n\nSee [SECURITY.md](SECURITY.md) for vulnerability reporting.\n\n### Security Scanning\n\n**Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:\n\n```bash\n# Run security audit locally\nempathy workflow run security-audit\n\n# Scan specific directory\nempathy workflow run security-audit --input '{\"path\":\"./src\"}'\n```\n\n**Documentation:**\n\n- **[Developer Workflow Guide](docs/DEVELOPER_SECURITY_WORKFLOW.md)** - Quick reference for handling security findings (all developers)\n- **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)\n- **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)\n- **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)\n- **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)\n\n**Key achievements:**\n\n- 82.3% reduction in false positives (350 → 62 findings)\n- 16x improvement in scanner accuracy\n- \u003c15 minute average fix time for critical issues\n- Zero critical vulnerabilities in production code\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n---\n\n## License\n\n**Apache License 2.0** - Free and open source for everyone. Use it, modify it, build commercial products with it. [Details →](LICENSE)\n\n---\n\n## Acknowledgements\n\nThis project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.\n\n**[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**\n\nSpecial thanks to:\n\n- **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol\n- **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration\n- **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework\n- **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless\n\nAnd to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)\n\nWant to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)\n\n---\n\n**Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Examples](examples/) · [Issues](https://github.com/Smart-AI-Memory/empathy-framework/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmart-ai-memory%2Fempathy-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmart-ai-memory%2Fempathy-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmart-ai-memory%2Fempathy-framework/lists"}