GitHub - RhyChaw/palace-ai · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
RhyChaw
palace-ai
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>10 Commits<br>10 Commits
.github/workflows
.github/workflows
examples
examples
palace-out
palace-out
palace
palace
tests/fixture
tests/fixture
.env.example
.env.example
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
plan.md
plan.md
pyproject.toml
pyproject.toml
View all files
Repository files navigation
palace-ai
AI agents navigate code the way humans remember — by association, not search.
pip install palace-ai<br>palace build .<br>palace query "auth flow"
Build a traversable memory palace for any repository.
palace-ai turns a codebase into rooms and typed relationships so agents orient before opening raw files.
AST-only by default — no API key. Use --llm plus ANTHROPIC_API_KEY for richer room summaries.
What it does
Instead of dumping tens of thousands of tokens of source into context, an agent can read:
palace-out/PALACE.md — map of rooms
One room file — structure, exports, call hints
Only the source files it actually needs
On medium-to-large repos, navigation via the palace is often 10–42× smaller in tokens than reading the full tree (run palace stats after a build).
Quick start
pip install palace-ai<br>palace build .<br>palace query "your topic"<br>palace serve # optional: graph visualizer<br>palace install claude # Claude Code: CLAUDE.md + PreToolUse hook
Explicit AST-only (same as default):
palace build . --no-llm
LLM-enriched rooms:
export ANTHROPIC_API_KEY=sk-...<br>palace build . --llm
Repo layout
Path<br>Purpose
palace/<br>Python package
palace-out/<br>Small checked-in sample (from tests/fixture)
examples/worked/<br>Larger pre-built palaces (e.g. requests) for demos
tests/fixture/<br>Tiny JS/Python fixtures for local builds
2-minute demo
After clone — sample palace is at ./palace-out/:
pip install palace-ai<br>git clone https://github.com/RhyChaw/palace-ai.git && cd palace-ai<br>palace query "main" --threshold 0.05<br>palace serve
Larger graph — pre-built requests palace:
git clone https://github.com/RhyChaw/palace-ai.git && cd palace-ai<br>palace query "auth flow" --path examples/worked/requests<br>palace serve --path examples/worked/requests
License
MIT — see LICENSE.
About
No description, website, or topics provided.
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
tags
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Python<br>68.5%
HTML<br>31.4%
JavaScript<br>0.1%
You can’t perform that action at this time.