Public recordAt risk
Software health reportschema 0.14.0 · metrics 1.13.0 · 2026-07-18 23:32 UTC
bxw91 / brainpalace
Vector Graph RAG for code & docs with Persistent Chat-Session Memory — BM25 (multi-lang), AST chunking. Hybrid, Compute, Scan, Timeline, Absence, Salience. Graph + temporal knowledge. Privacy Stamps. Source Adapters. Chat summarisation + verbatim copy + free scan. Git indexing. CLI, MCP and Claude Code plugin. Ollama or cloud LLMs. Dashboard.
bxw91/brainpalace holds a health index of 48 out of 100, placing it in the At risk band. It scores highest on Vitality (75/100) and lowest on Sustainability & Governance (28/100). It was last updated today. A single contributor accounts for most of its recent work.
48
overall / 100Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
48
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Ownership
bxw91Personal account
0 followers1 public reposince Jul 2025
This repository is owned by a personal account. A single-owner project carries more continuity risk than an organization-backed one.
Package ecosystems
| Registry | Package | Version | Downloads / mo | Versions | Last publish | Tags |
|---|---|---|---|---|---|---|
| PyPI | brainpalace-cli | 26.7.8 | 3,003 | 62 | 0 days ago | brainpalaceragcliai-memoryllm-memorysemantic-searchai-agentclaude-codeagent-memory |
| PyPI | brainpalace-dashboard | 26.7.8 | 2,687 | 37 | 0 days ago | — |
| PyPI | brainpalace-rag | 26.7.8 | - | 62 | 0 days ago | brainpalaceragsemantic-searchai-memoryllm-memorydocumentationindexingllama-indexchromadbai-agentclaude-codeagent-memory |
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
75
Development activity
58Moderate
How it's scored
| 36/36 | Push recency — last push 0 days ago |
| 4.8/36 | Commit cadence — 7/52 weeks with commits |
| 16.9/18 | Commit volume — 76 commits in the last year |
| 0/10 | OpenSSF Scorecard: Maintained — project was created within the last 90 days. Please review its contents carefully |
Inputs used
| commits_last_year | 76 |
| human_commit_share | — |
| days_since_last_push | 0 |
| active_weeks_last_year | 7 |
Release discipline
100Excellent
How it's scored
| 27/27 | Ships releases — 63 releases published |
| 36/36 | Release recency — latest release 0 days ago |
| 27/27 | Release cadence — a release every ~2.2 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — no data |
Inputs used
| releases_count | 63 |
| latest_release_tag | v26.7.8 |
| releases_from_tags | no |
| days_since_latest_release | 0 |
| mean_days_between_releases | 2.2 |
Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
34
Popularity & adoption
1Critical
How it's scored
| 0/60 | Stars — 2 stars |
| 0/25 | Forks — 0 forks |
| 0/15 | Watchers — 1 watchers |
Inputs used
| forks | 0 |
| stars | 2 |
| watchers | 1 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Community health
50Moderate
How it's scored
| 22.5/22.5 | README |
| 22.5/22.5 | License — recognized license (MIT) |
| 0/18 | CONTRIBUTING guide |
| 0/13.5 | Code of conduct |
| 0/7.2 | Issue template |
| 0/6.3 | PR template |
Inputs used
| has_readme | yes |
| has_license | yes |
| has_contributing | no |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | no |
Ecosystem adoption (downloads)
63Moderate
How it's scored
| 50.1/80 | Monthly downloads — 5,690 downloads/month across pypi |
| 0/20 | Registry dependents — not reported by this ecosystem |
Inputs used
| packages | brainpalace-cli, brainpalace-dashboard, brainpalace-rag |
| dependents | — |
| ecosystems | pypi |
| total_downloads | — |
| monthly_downloads | 5,690 |
Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
28
Maintainer resilience (bus factor)
10Critical
How it's scored
| 9/54 | Bus factor — 1 contributor(s) cover half of all commits |
| 0/22.5 | Commit distribution — top contributor authored 100% of commits |
| 1.4/13.5 | Contributor breadth — 1 contributors |
| 0/10 | OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 1 |
| top_contributor_share | 1 |
Issue & PR responsiveness
1Critical
How it's scored
| 0/46.8 | Issue resolution — no issues or no data |
| 0/38.3 | PR acceptance — 0/1 decided PRs merged |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
Inputs used
| merged_prs | 0 |
| open_issues | 0 |
| closed_issues | 0 |
| issue_closed_ratio | — |
| closed_unmerged_prs | 1 |
Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.
Ownership & stewardship
18Critical
How it's scored
| 10/30 | Ownership backing — personal (user) account |
| 0/20 | Verified domain — not applicable to user accounts |
| 0/25 | Owner reach — 0 followers of bxw91 |
| 4.2/25 | Track record — 1 public repos, account ~1 yr old |
Inputs used
| followers | 0 |
| owner_type | User |
| is_verified | — |
| owner_login | bxw91 |
| public_repos | 1 |
| account_age_days | 366 |
Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.
Package maintenance
100Excellent
How it's scored
| 25/25 | Published & resolvable — 3 package(s) on pypi |
| 35/35 | Publish recency — latest publish 0 days ago |
| 20/20 | Version history — 62 published versions |
| 20/20 | Not deprecated — active, not deprecated or yanked |
Inputs used
| packages | brainpalace-cli, brainpalace-dashboard, brainpalace-rag |
| ecosystems | pypi |
| any_deprecated | no |
| min_days_since_publish | 0 |
Engineering Quality
Are baseline engineering and documentation practices in place?
72
Engineering practices
60Moderate
How it's scored
| 24/24 | CI workflows — 4 workflow(s) |
| 24/24 | Tests present |
| 0/16 | Linter config |
| 0/9.6 | Pre-commit hooks |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard: CI-Tests — no data |
Inputs used
| has_ci | yes |
| has_tests | yes |
| has_editorconfig | no |
| has_linter_config | no |
| has_precommit_config | no |
Excluded from scoring (no data or not applicable): OpenSSF Scorecard: CI-Tests. Remaining weights renormalized.
Documentation
90Excellent
How it's scored
| 30/30 | README |
| 25/25 | Documentation directory |
| 15/15 | Documentation / homepage site — https://github.com/bxw91/brainpalace#readme |
| 10/10 | Repository description |
| 10/10 | Topics — 11 topics |
| 0/10 | Wiki |
Inputs used
| topics | ai-memory, bm25, claude-code, embeddings, graphrag, knowledge-graph, llm, mcp, python, rag, semantic-search |
| has_wiki | no |
| homepage | https://github.com/bxw91/brainpalace#readme |
| has_readme | yes |
| has_docs_dir | yes |
| has_description | yes |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
29
Security posture
29Critical
How it's scored
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — no data |
| 0/2.5 | CI-Tests — no data |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
| 0/2.5 | Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | License — license file detected |
| 0/7.5 | Maintained — project was created within the last 90 days. Please review its contents carefully |
| 5/5 | Packaging — packaging workflow detected |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — no SAST tool detected |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — no data |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 0/7.5 | Vulnerabilities — 165 existing vulnerabilities detected |
Inputs used
| source | openssf_scorecard |
| checks_evaluated | 15 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 3 |
| scorecard_aggregate | 2.9 |
Excluded from scoring (no data or not applicable): branch_protection, ci_tests, signed_releases. Remaining weights renormalized.
AI Readiness
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
67
Agent context & guidance
75Good
How it's scored
| 45/45 | Agent instructions — CLAUDE.md, brainpalace-cli/tests/AGENTS.md, brainpalace-cli/tests/CLAUDE.md, brainpalace-server/brainpalace_server/api/AGENTS.md, brainpalace-server/brainpalace_server/api/CLAUDE.md, brainpalace-server/tests/AGENTS.md, brainpalace-server/tests/CLAUDE.md, e2e/integration/AGENTS.md, e2e/integration/CLAUDE.md |
| 0/15 | Machine-readable docs (llms.txt) |
| 0/40 | Legible commit history — no data |
Inputs used
| has_llms_txt | no |
| legible_history_share | — |
| agent_instruction_files | CLAUDE.md, brainpalace-cli/tests/AGENTS.md, brainpalace-cli/tests/CLAUDE.md, brainpalace-server/brainpalace_server/api/AGENTS.md, brainpalace-server/brainpalace_server/api/CLAUDE.md, brainpalace-server/tests/AGENTS.md, brainpalace-server/tests/CLAUDE.md, e2e/integration/AGENTS.md, e2e/integration/CLAUDE.md |
| agent_instruction_max_bytes | 14,197 |
Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.
How it's scored
| 18/18 | One-command bootstrap — Taskfile.yml, brainpalace-cli/Taskfile.yml, brainpalace-dashboard/Taskfile.yml, brainpalace-life/Taskfile.yml, brainpalace-server/Taskfile.yml |
| 22/22 | Automated tests |
| 0/11 | Lint / format config |
| 11/11 | Static type checking — brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json |
| 10/10 | Reproducible environment — lockfile |
| 0/10 | Demonstrated agent practice — no data |
| 0/8 | Automated maintenance — no data |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | package-lock.json, poetry.lock |
| has_dockerfile | no |
| typed_language | no |
| bootstrap_files | Taskfile.yml, brainpalace-cli/Taskfile.yml, brainpalace-dashboard/Taskfile.yml, brainpalace-life/Taskfile.yml, brainpalace-server/Taskfile.yml |
| has_devcontainer | no |
| has_linter_config | no |
| typecheck_configs | brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json |
| agent_commit_share | — |
| toolchain_manifests | — |
| dependency_bot_commit_share | — |
Excluded from scoring (no data or not applicable): Demonstrated agent practice, Automated maintenance. Remaining weights renormalized.
How it's scored
| 27/45 | Type-checkable code — Python with type-check config (brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json) |
| 54.8/55 | Manageable file sizes — 5/1,197 source files over 60KB |
Inputs used
| primary_language | Python |
| largest_source_bytes | 126,126 |
| source_files_sampled | 1,197 |
| oversized_source_files | 5 |
Machine-readable interfaces
20Critical
How it's scored
| 0/40 | API schema (OpenAPI/GraphQL/proto) |
| 20/20 | MCP server |
| 0/40 | Runnable examples |
Inputs used
| example_dirs | — |
| has_mcp_signal | yes |
| api_schema_files | — |
Key facts
2GitHub stars
1contributors
76commits, last 12 months
0days since last push
63releases
1bus factor
0open issues
PyPIpackage ecosystems
Data collection warnings
- Could not fetch pypi package 'brainpalace-life' from its registry
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
More detail
OpenSSF Scorecard 2.9 / 10
2.9aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).
| 10 | Binary-Artifacts | no binaries found in the repo |
| n/a | Branch-Protection | internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md |
| n/a | CI-Tests | no pull request found |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 0/30 approved changesets -- score normalized to 0 |
| 0 | Contributors | project has 0 contributing companies or organizations -- score normalized to 0 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 0 | Maintained | project was created within the last 90 days. Please review its contents carefully |
| 10 | Packaging | packaging workflow detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | no SAST tool detected |
| 0 | Security-Policy | security policy file not detected |
| n/a | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 165 existing vulnerabilities detected |
Direct dependencies 42
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| PyPI | click | ^8.1.0 | brainpalace-cli/pyproject.toml |
| PyPI | httpx | ^0.28.0 | brainpalace-cli/pyproject.toml |
| PyPI | rich | ^13.9.0 | brainpalace-cli/pyproject.toml |
| PyPI | pyyaml | ^6.0.0 | brainpalace-cli/pyproject.toml |
| PyPI | pydantic | ^2.10.0 | brainpalace-cli/pyproject.toml |
| PyPI | brainpalace-rag | ^26.5.1 | brainpalace-cli/pyproject.toml |
| PyPI | mcp | >=1.0,<2.0 | brainpalace-cli/pyproject.toml |
| PyPI | brainpalace-dashboard | ^26.5.1 | brainpalace-cli/pyproject.toml |
| PyPI | fastapi | ^0.115 | brainpalace-dashboard/pyproject.toml |
| PyPI | uvicorn | ^0.32.0 | brainpalace-dashboard/pyproject.toml |
| PyPI | httpx | ^0.28.0 | brainpalace-dashboard/pyproject.toml |
| PyPI | sse-starlette | ^2.1 | brainpalace-dashboard/pyproject.toml |
| PyPI | brainpalace-cli | — | brainpalace-dashboard/pyproject.toml |
| PyPI | brainpalace-rag | — | brainpalace-life/pyproject.toml |
| PyPI | fastapi | ^0.115.0 | brainpalace-server/pyproject.toml |
| PyPI | uvicorn | ^0.32.0 | brainpalace-server/pyproject.toml |
| PyPI | llama-index-core | ^0.14.0 | brainpalace-server/pyproject.toml |
| PyPI | llama-index-readers-file | ^0.5.0 | brainpalace-server/pyproject.toml |
| PyPI | llama-index-embeddings-openai | ^0.5.0 | brainpalace-server/pyproject.toml |
| PyPI | chromadb | ^0.5.0 | brainpalace-server/pyproject.toml |
| PyPI | openai | ^1.57.0 | brainpalace-server/pyproject.toml |
| PyPI | anthropic | ^0.40.0 | brainpalace-server/pyproject.toml |
| PyPI | tiktoken | ^0.8.0 | brainpalace-server/pyproject.toml |
| PyPI | pydantic | ^2.10.0 | brainpalace-server/pyproject.toml |
| PyPI | pydantic-settings | ^2.6.0 | brainpalace-server/pyproject.toml |
| PyPI | python-dotenv | ^1.0.0 | brainpalace-server/pyproject.toml |
| PyPI | click | ^8.1.0 | brainpalace-server/pyproject.toml |
| PyPI | llama-index-llms-openai | ^0.6.12 | brainpalace-server/pyproject.toml |
| PyPI | tree-sitter-language-pack | ^0.7.3 | brainpalace-server/pyproject.toml |
| PyPI | pyyaml | ^6.0.0 | brainpalace-server/pyproject.toml |
| PyPI | pathspec | ^0.12.0 | brainpalace-server/pyproject.toml |
| PyPI | setuptools | >=65 | brainpalace-server/pyproject.toml |
| PyPI | cohere | ^5.0.0 | brainpalace-server/pyproject.toml |
| PyPI | google-genai | ^1.0.0 | brainpalace-server/pyproject.toml |
| PyPI | sentence-transformers | ^3.4.0 | brainpalace-server/pyproject.toml |
| PyPI | asyncpg | ^0.29.0 | brainpalace-server/pyproject.toml |
| PyPI | sqlalchemy | ^2.0.0 | brainpalace-server/pyproject.toml |
| PyPI | cachetools | >=5.3 | brainpalace-server/pyproject.toml |
| PyPI | PyStemmer | ^2.2.0 | brainpalace-server/pyproject.toml |
| PyPI | bm25s | ^0.2.14 | brainpalace-server/pyproject.toml |
| PyPI | py3langid | ^0.3.0 | brainpalace-server/pyproject.toml |
| PyPI | simplemma | ^1.2 | brainpalace-server/pyproject.toml |
All dependencies not collected
The resolved dependency set could not be collected for this report: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"ai-memory",
"bm25",
"claude-code",
"embeddings",
"graphrag",
"knowledge-graph",
"llm",
"mcp",
"python",
"rag",
"semantic-search"
],
"is_fork": false,
"size_kb": 18726,
"has_wiki": false,
"homepage": "https://github.com/bxw91/brainpalace#readme",
"languages": {
"CSS": 4118,
"HTML": 176434,
"Shell": 190812,
"Python": 6543591,
"JavaScript": 81,
"TypeScript": 615681
},
"pushed_at": "2026-07-18T22:18:00Z",
"created_at": "2026-05-30T08:29:03Z",
"owner_type": "User",
"updated_at": "2026-07-18T22:18:02Z",
"description": "Vector Graph RAG for code & docs with Persistent Chat-Session Memory — BM25 (multi-lang), AST chunking. Hybrid, Compute, Scan, Timeline, Absence, Salience. Graph + temporal knowledge. Privacy Stamps. Source Adapters. Chat summarisation + verbatim copy + free scan. Git indexing. CLI, MCP and Claude Code plugin. Ollama or cloud LLMs. Dashboard.",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": null,
"name": null,
"type": "User",
"login": "bxw91",
"company": null,
"location": null,
"followers": 0,
"avatar_url": "https://avatars.githubusercontent.com/u/221414203?v=4",
"created_at": "2025-07-17T19:31:33Z",
"is_verified": null,
"public_repos": 1,
"account_age_days": 366
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases_count": 63,
"commits_last_year": 76,
"latest_release_at": "2026-07-18T22:18:06Z",
"latest_release_tag": "v26.7.8",
"releases_from_tags": false,
"days_since_last_push": 0,
"active_weeks_last_year": 7,
"days_since_latest_release": 0,
"mean_days_between_releases": 2.2
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 42,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "brainpalace-cli",
"exists": true,
"license": "MIT",
"keywords": [
"brainpalace",
"rag",
"cli",
"ai-memory",
"llm-memory",
"semantic-search",
"ai-agent",
"claude-code",
"agent-memory",
"Development Status :: 4 - Beta",
"Environment :: Console",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/brainpalace-cli/",
"is_deprecated": false,
"latest_version": "26.7.8",
"repository_url": "https://github.com/bxw91/brainpalace",
"versions_count": 62,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 3003,
"first_published_at": "2026-05-30T09:15:51.601146Z",
"latest_published_at": "2026-07-18T22:27:43.923918Z",
"latest_version_yanked": null,
"days_since_latest_publish": 0
},
{
"name": "brainpalace-dashboard",
"exists": true,
"license": null,
"keywords": [
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14"
],
"ecosystem": "pypi",
"matches_repo": null,
"registry_url": "https://pypi.org/project/brainpalace-dashboard/",
"is_deprecated": false,
"latest_version": "26.7.8",
"repository_url": null,
"versions_count": 37,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 2687,
"first_published_at": "2026-06-07T14:24:08.861170Z",
"latest_published_at": "2026-07-18T22:29:00.755862Z",
"latest_version_yanked": null,
"days_since_latest_publish": 0
},
{
"name": "brainpalace-rag",
"exists": true,
"license": "MIT",
"keywords": [
"brainpalace",
"rag",
"semantic-search",
"ai-memory",
"llm-memory",
"documentation",
"indexing",
"llama-index",
"chromadb",
"ai-agent",
"claude-code",
"agent-memory",
"Development Status :: 4 - Beta",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14",
"Topic :: Software Development :: Documentation",
"Topic :: Text Processing :: Indexing"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/brainpalace-rag/",
"is_deprecated": false,
"latest_version": "26.7.8",
"repository_url": "https://github.com/bxw91/brainpalace",
"versions_count": 62,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": null,
"first_published_at": "2026-05-30T09:15:16.311945Z",
"latest_published_at": "2026-07-18T22:26:55.011548Z",
"latest_version_yanked": null,
"days_since_latest_publish": 0
}
]
},
"popularity": {
"forks": 0,
"stars": 2,
"watchers": 1,
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": true,
"bootstrap_files": [
"Taskfile.yml",
"brainpalace-cli/Taskfile.yml",
"brainpalace-dashboard/Taskfile.yml",
"brainpalace-life/Taskfile.yml",
"brainpalace-server/Taskfile.yml"
],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"brainpalace-dashboard/frontend/tsconfig.json",
"e2e/dashboard/tsconfig.json"
],
"largest_source_bytes": 126126,
"source_files_sampled": 1197,
"oversized_source_files": 5,
"agent_instruction_files": [
"CLAUDE.md",
"brainpalace-cli/tests/AGENTS.md",
"brainpalace-cli/tests/CLAUDE.md",
"brainpalace-server/brainpalace_server/api/AGENTS.md",
"brainpalace-server/brainpalace_server/api/CLAUDE.md",
"brainpalace-server/tests/AGENTS.md",
"brainpalace-server/tests/CLAUDE.md",
"e2e/integration/AGENTS.md",
"e2e/integration/CLAUDE.md"
],
"agent_instruction_max_bytes": 14197
},
"dependencies": {
"manifests": [
"brainpalace-cli/pyproject.toml",
"brainpalace-dashboard/pyproject.toml",
"brainpalace-life/pyproject.toml",
"brainpalace-server/pyproject.toml"
],
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "click",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^8.1.0"
},
{
"name": "httpx",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.28.0"
},
{
"name": "rich",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^13.9.0"
},
{
"name": "pyyaml",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^6.0.0"
},
{
"name": "pydantic",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^2.10.0"
},
{
"name": "brainpalace-rag",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^26.5.1"
},
{
"name": "mcp",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.0,<2.0"
},
{
"name": "brainpalace-dashboard",
"manifest": "brainpalace-cli/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^26.5.1"
},
{
"name": "fastapi",
"manifest": "brainpalace-dashboard/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.115"
},
{
"name": "uvicorn",
"manifest": "brainpalace-dashboard/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.32.0"
},
{
"name": "httpx",
"manifest": "brainpalace-dashboard/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.28.0"
},
{
"name": "sse-starlette",
"manifest": "brainpalace-dashboard/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^2.1"
},
{
"name": "brainpalace-cli",
"manifest": "brainpalace-dashboard/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "brainpalace-rag",
"manifest": "brainpalace-life/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "fastapi",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.115.0"
},
{
"name": "uvicorn",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.32.0"
},
{
"name": "llama-index-core",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.14.0"
},
{
"name": "llama-index-readers-file",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.5.0"
},
{
"name": "llama-index-embeddings-openai",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.5.0"
},
{
"name": "chromadb",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.5.0"
},
{
"name": "openai",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^1.57.0"
},
{
"name": "anthropic",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.40.0"
},
{
"name": "tiktoken",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.8.0"
},
{
"name": "pydantic",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^2.10.0"
},
{
"name": "pydantic-settings",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^2.6.0"
},
{
"name": "python-dotenv",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^1.0.0"
},
{
"name": "click",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^8.1.0"
},
{
"name": "llama-index-llms-openai",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.6.12"
},
{
"name": "tree-sitter-language-pack",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.7.3"
},
{
"name": "pyyaml",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^6.0.0"
},
{
"name": "pathspec",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.12.0"
},
{
"name": "setuptools",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=65"
},
{
"name": "cohere",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^5.0.0"
},
{
"name": "google-genai",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^1.0.0"
},
{
"name": "sentence-transformers",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^3.4.0"
},
{
"name": "asyncpg",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.29.0"
},
{
"name": "sqlalchemy",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^2.0.0"
},
{
"name": "cachetools",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=5.3"
},
{
"name": "PyStemmer",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^2.2.0"
},
{
"name": "bm25s",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.2.14"
},
{
"name": "py3langid",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^0.3.0"
},
{
"name": "simplemma",
"manifest": "brainpalace-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": "^1.2"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 0,
"open_issues": 0,
"closed_ratio": null,
"closed_issues": 0,
"closed_unmerged_prs": 1
},
"bus_factor": 1,
"top_contributors": [
{
"type": "User",
"login": "bxw91",
"commits": 78,
"avatar_url": "https://avatars.githubusercontent.com/u/221414203?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"e2e-nightly.yml",
"pr-qa-gate.yml",
"provider-e2e.yml",
"publish-to-pypi.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [
"package-lock.json",
"poetry.lock"
],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": null,
"reason": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": null,
"reason": "no pull request found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 0,
"reason": "project has 0 contributing companies or organizations -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 0,
"reason": "project was created within the last 90 days. Please review its contents carefully",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": 10,
"reason": "packaging workflow detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "no SAST tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "165 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "b2112801156dfa6e6f674f4bd6c3959702ce93ba",
"ran_at": "2026-07-18T23:32:25Z",
"aggregate_score": 2.9,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/bxw91/brainpalace",
"host": "github.com",
"name": "brainpalace",
"owner": "bxw91"
},
"metrics": {
"overall": {
"key": "overall",
"band": "at_risk",
"name": "Overall health",
"note": null,
"notes": [],
"value": 48,
"inputs": {
"security": 29,
"vitality": 75,
"community": 34,
"governance": 28,
"engineering": 72
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 75,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "moderate",
"name": "Development activity",
"note": null,
"notes": [],
"value": 58,
"inputs": {
"commits_last_year": 76,
"human_commit_share": null,
"days_since_last_push": 0,
"active_weeks_last_year": 7
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 0 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 0
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "7/52 weeks with commits",
"points": 4.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 7
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "76 commits in the last year",
"points": 16.9,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 76
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "project was created within the last 90 days. Please review its contents carefully",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"releases_count": 63,
"latest_release_tag": "v26.7.8",
"releases_from_tags": false,
"days_since_latest_release": 0,
"mean_days_between_releases": 2.2
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "63 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 63
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 0 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 0
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~2.2 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 2.2
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "unverified",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": "repository_too_young",
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": null,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "maintenance record not established from the collected data",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_unverified",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 34,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 1,
"inputs": {
"forks": 0,
"stars": 2,
"watchers": 1,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "2 stars",
"points": 0,
"status": "missed",
"details": [
{
"code": "stars",
"params": {
"count": 2
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "0 forks",
"points": 0,
"status": "missed",
"details": [
{
"code": "forks",
"params": {
"count": 0
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "1 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 1
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 50,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "moderate",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 63,
"inputs": {
"packages": [
"brainpalace-cli",
"brainpalace-dashboard",
"brainpalace-rag"
],
"dependents": null,
"ecosystems": "pypi",
"total_downloads": null,
"monthly_downloads": 5690
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "5,690 downloads/month across pypi",
"points": 50.1,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 5690,
"ecosystems": "pypi"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "critical",
"name": "Sustainability & Governance",
"value": 28,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 10,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "critical",
"name": "Issue & PR responsiveness",
"note": "Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"issue_resolution"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 1,
"inputs": {
"merged_prs": 0,
"open_issues": 0,
"closed_issues": 0,
"issue_closed_ratio": null,
"closed_unmerged_prs": 1
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "no issues or no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_issues_or_data",
"params": {}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "0/1 decided PRs merged",
"points": 0,
"status": "missed",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 0,
"decided": 1
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "critical",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 18,
"inputs": {
"followers": 0,
"owner_type": "User",
"is_verified": null,
"owner_login": "bxw91",
"public_repos": 1,
"account_age_days": 366
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "0 followers of bxw91",
"points": 0,
"status": "missed",
"details": [
{
"code": "owner_followers",
"params": {
"count": 0,
"login": "bxw91"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "1 public repos, account ~1 yr old",
"points": 4.2,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 1
}
},
{
"code": "account_age_years",
"params": {
"years": 1
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"brainpalace-cli",
"brainpalace-dashboard",
"brainpalace-rag"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 0
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "3 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 3,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 0 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 0
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "62 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 62
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 72,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: CI-Tests. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_ci_tests"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 60,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "4 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 4
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "no pull request found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"topics": [
"ai-memory",
"bm25",
"claude-code",
"embeddings",
"graphrag",
"knowledge-graph",
"llm",
"mcp",
"python",
"rag",
"semantic-search"
],
"has_wiki": false,
"homepage": "https://github.com/bxw91/brainpalace#readme",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://github.com/bxw91/brainpalace#readme",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "11 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 11
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "critical",
"name": "Security",
"value": 29,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "critical",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Branch-Protection, CI-Tests, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"branch_protection",
"ci_tests",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 29,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 15,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 3,
"scorecard_aggregate": 2.9
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "no pull request found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "project was created within the last 90 days. Please review its contents carefully",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "no SAST tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "165 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "moderate",
"name": "AI Readiness",
"value": 67,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "good",
"name": "Agent context & guidance",
"note": "Excluded from scoring (no data or not applicable): Legible commit history. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"legible_commit_history"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 75,
"inputs": {
"has_llms_txt": false,
"legible_history_share": null,
"agent_instruction_files": [
"CLAUDE.md",
"brainpalace-cli/tests/AGENTS.md",
"brainpalace-cli/tests/CLAUDE.md",
"brainpalace-server/brainpalace_server/api/AGENTS.md",
"brainpalace-server/brainpalace_server/api/CLAUDE.md",
"brainpalace-server/tests/AGENTS.md",
"brainpalace-server/tests/CLAUDE.md",
"e2e/integration/AGENTS.md",
"e2e/integration/CLAUDE.md"
],
"agent_instruction_max_bytes": 14197
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "CLAUDE.md, brainpalace-cli/tests/AGENTS.md, brainpalace-cli/tests/CLAUDE.md, brainpalace-server/brainpalace_server/api/AGENTS.md, brainpalace-server/brainpalace_server/api/CLAUDE.md, brainpalace-server/tests/AGENTS.md, brainpalace-server/tests/CLAUDE.md, e2e/integration/AGENTS.md, e2e/integration/CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "CLAUDE.md, brainpalace-cli/tests/AGENTS.md, brainpalace-cli/tests/CLAUDE.md, brainpalace-server/brainpalace_server/api/AGENTS.md, brainpalace-server/brainpalace_server/api/CLAUDE.md, brainpalace-server/tests/AGENTS.md, brainpalace-server/tests/CLAUDE.md, e2e/integration/AGENTS.md, e2e/integration/CLAUDE.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "good",
"name": "Verify loop (build / test / typecheck)",
"note": "Excluded from scoring (no data or not applicable): Demonstrated agent practice, Automated maintenance. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"demonstrated_agent_practice",
"automated_maintenance"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 74,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"package-lock.json",
"poetry.lock"
],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [
"Taskfile.yml",
"brainpalace-cli/Taskfile.yml",
"brainpalace-dashboard/Taskfile.yml",
"brainpalace-life/Taskfile.yml",
"brainpalace-server/Taskfile.yml"
],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"brainpalace-dashboard/frontend/tsconfig.json",
"e2e/dashboard/tsconfig.json"
],
"agent_commit_share": null,
"toolchain_manifests": [],
"dependency_bot_commit_share": null
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": "Taskfile.yml, brainpalace-cli/Taskfile.yml, brainpalace-dashboard/Taskfile.yml, brainpalace-life/Taskfile.yml, brainpalace-server/Taskfile.yml",
"points": 18,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Taskfile.yml, brainpalace-cli/Taskfile.yml, brainpalace-dashboard/Taskfile.yml, brainpalace-life/Taskfile.yml, brainpalace-server/Taskfile.yml"
}
}
],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 126126,
"source_files_sampled": 1197,
"oversized_source_files": 5
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "brainpalace-dashboard/frontend/tsconfig.json, e2e/dashboard/tsconfig.json",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "5/1197 source files over 60KB",
"points": 54.8,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 1197,
"oversized": 5
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "critical",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 20,
"inputs": {
"example_dirs": [],
"has_mcp_signal": true,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 20,
"status": "met",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Could not fetch pypi package 'brainpalace-life' from its registry",
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-07-18T23:32:32.920338Z",
"schema_version": "0.14.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/b/bxw91/brainpalace.svg",
"full_name": "bxw91/brainpalace",
"license_state": "standard",
"license_spdx": "MIT"
}Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.14.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics — PyPI.