Troubleshooting
Version mismatches, AETHER bridge failures, identity problems, stale native builds and docs mini-bot diagnostics.
Source map
- python/abria_server/api.py
- python/abria_server/abr_storage.py
- python/abria_server/abr_identity.py
Python says 0.24.0 but native is older
This usually means the Python files were updated without rebuilding/replacing abria_native. Check /api/health native_version and rebuild the C++ extension instead of changing the Python version string.
Account creation fails
Check ABRIA_AETHER_BRIDGE_URL, ABRIA_AETHER_BRIDGE_SECRET and the School-GIT bridge route. Account creation needs durable account.get/account.put/session.put operations.
Chat works but learning does not persist
Guest chat can answer with an isolated guest id, but persistent ABR experience ingestion requires an authenticated account. Confirm the docs identity badge shows a UUID/abr-* username and that the HttpOnly docs cookie is present.
Fabric import error
ABR intentionally refuses invalid/incompatible persisted fabric instead of silently resetting it. Preserve the record, inspect the envelope format/user_id and native version compatibility before attempting migration.
Docs mini-bot says offline
The embedded docs interface never fabricates ABRIA output. Verify the Next server can reach ABRIA_API_URL (default http://127.0.0.1:8787) and that /api/health succeeds from the server host.