{"name":"logOS","tagline":"where minds meet","description":"a registry for soma checkpoints: small continual-learning models that train on raw byte streams with fixed memory. users upload checkpoints, others download and continue training. identity is cryptographic (sha256 of state); declared lineage is self-reported.","version":"1.0.0","author":"james blight","url":"https://logossoma.com","llms_txt":"https://logossoma.com/llms.txt","paper":"Time Is All You Need: Temporal Translation and the Credit Assignment Problem (AAAI 2026)","audience":["robotics","embodied AI","edge computing","sensor fusion","continual learning","byte-level language modeling","offline/local-first AI"],"pages":{"home":"https://logossoma.com/ — chronological feed of uploads; '?tab=following' for the authenticated user's follows","search":"https://logossoma.com/checkpoints — filterable list of checkpoints; '?tab=creators' switches to creator search","checkpoint_detail":"https://logossoma.com/checkpoints/{id} — single checkpoint with metadata, comments, star/share","profile":"https://logossoma.com/u/{username} — public profile with uploads, follower/following counts, follow button","upload":"https://logossoma.com/upload — authenticated upload UI (presigned direct-to-R2)","about":"https://logossoma.com/about","paper":"https://logossoma.com/paper","specs":"https://logossoma.com/specs — full soma architecture reference"},"auth":{"method":"google oauth 2.0","login_url":"https://logossoma.com/api/auth/google/login?origin=https://logossoma.com","session":"on success, a session cookie is set AND a bearer token is returned via URL fragment `#token=<session_token>`. use either: cookie (Set-Cookie: session_token=...) or header (Authorization: Bearer <session_token>). sessions last 30 days.","me":"GET https://logossoma.com/api/auth/me — returns the current user or 401","logout":"POST https://logossoma.com/api/auth/logout"},"workflows":{"browse_and_download":["1. GET https://logossoma.com/api/checkpoints?search=&tags=&sort=stars — find a checkpoint, get its checkpoint_id","2. GET https://logossoma.com/api/checkpoints/{checkpoint_id} — verify metadata, compatibility (n_bands + hidden_dim + base + direct_readout)","3. POST https://logossoma.com/api/checkpoints/{checkpoint_id}/download — returns {'download_url': presigned, 'file_size_bytes': N}. the url is signed for 1 hour; rate-limited to 10/min/ip.","4. GET <download_url> — binary .pt file. load with torch.load(path, map_location='cpu', weights_only=False)."],"upload_a_checkpoint":["auth required.","1. train/save a .pt with soma_v8 (see /specs). it must carry: W, traces, n_bands, base, hidden_dim, checkpoint_id, checkpoint_history, soma_version.","2. POST https://logossoma.com/api/checkpoints/upload/presign with body {'filename': 'model.pt', 'file_size': N} — returns {'upload_id', 'presigned_url', 'r2_key'}","3. PUT <presigned_url> with the raw file bytes and header 'Content-Type: application/octet-stream' — upload goes direct to cloudflare r2, bypassing the API","4. POST https://logossoma.com/api/checkpoints/upload/confirm with body {'upload_id', 'r2_key', 'filename'} — server downloads, parses metadata via subprocess, moves to final key, returns parsed metadata","5. POST https://logossoma.com/api/checkpoints with the register body (name, corpus_tags, description, og_tagline, checkpoint_id, n_bands, hidden_dim, base, direct_readout, bytes_seen, soma_version, checkpoint_history, file_size_bytes) — creates the registry entry","6. the canonical share URL is https://logossoma.com/api/share/{checkpoint_id} — serves an OG card that previews on any social platform"],"continue_someone_elses_training":["download a checkpoint per 'browse_and_download'.","train locally with soma_v8: `python soma_v8.py` then choose 'train', checkpoint=<downloaded.pt>, corpus=<your_data>.","the new .pt will have a fresh checkpoint_id (hash of new state) and a checkpoint_history extending the parent's.","upload per 'upload_a_checkpoint'. the registry reads checkpoint_history from the file — declared lineage is visible but not cryptographically verified."],"social_interactions":["POST https://logossoma.com/api/checkpoints/{id}/star — toggle star (auth). returns {'starred': bool, 'star_count': int}","POST https://logossoma.com/api/users/{username}/follow — toggle follow (auth). returns {'following': bool, 'follower_count': int}","GET  https://logossoma.com/api/checkpoints/{id}/comments — list comments on a checkpoint","POST https://logossoma.com/api/checkpoints/{id}/comments with {'body': str} — post a comment (auth, 2000 char max)","DELETE https://logossoma.com/api/comments/{comment_id} — author or admin only","GET  https://logossoma.com/api/feed/following — checkpoints from followed creators (auth)","GET  https://logossoma.com/api/activity — mixed timeline of uploads + stars"],"edit_profile":["PATCH https://logossoma.com/api/users/me with {'bio'?, 'links'?, 'username'?} — 500/200 char limits; username must be unique"]},"endpoints":{"GET /api/checkpoints":{"auth":false,"query_params":{"search":"name, description, tag, or creator username (regex-insensitive)","tags":"comma-separated","n_bands":"int","hidden_dim":"int","base":"float","verified_only":"bool","min_bytes":"int","max_bytes":"int","sort":"downloads|stars|newest|trained","limit":"int (default 50, max 100)","offset":"int"}},"GET /api/checkpoints/{id}":{"auth":false},"POST /api/checkpoints/{id}/download":{"auth":false,"returns":"presigned url"},"POST /api/checkpoints/{id}/star":{"auth":true},"GET /api/checkpoints/{id}/comments":{"auth":false},"POST /api/checkpoints/{id}/comments":{"auth":true,"body":{"body":"str, max 2000"}},"DELETE /api/comments/{id}":{"auth":true,"notes":"author or admin"},"POST /api/users/{username}/follow":{"auth":true},"GET /api/users/{username}":{"auth":false},"PATCH /api/users/me":{"auth":true,"body":{"bio":"str","links":"list","username":"str"}},"GET /api/feed/following":{"auth":true},"GET /api/activity":{"auth":false},"GET /api/creators":{"auth":false,"query_params":{"sort":"stars|downloads|checkpoints|followers|newest","limit":"int"}},"GET /api/tags":{"auth":false},"POST /api/lineage/resolve":{"auth":false,"body":{"checkpoint_ids":"list of ids"}},"POST /api/checkpoints/upload/presign":{"auth":true,"body":{"filename":"str","file_size":"int"}},"POST /api/checkpoints/upload/confirm":{"auth":true,"body":{"upload_id":"str","r2_key":"str","filename":"str"}},"POST /api/checkpoints":{"auth":true,"notes":"register after upload confirm"},"PATCH /api/checkpoints/{id}":{"auth":true,"body":{"name":"str","description":"str","corpus_tags":"list","og_tagline":"str"},"notes":"creator or admin"},"DELETE /api/checkpoints/{id}":{"auth":true,"notes":"creator or admin"},"GET /api/og/checkpoint/{id}.png":{"auth":false,"returns":"1200x630 PNG (OG card)"},"GET /api/share/{id}":{"auth":false,"returns":"HTML share-page with OG/Twitter meta + redirect"},"GET /api/download/soma.py":{"auth":false,"returns":"soma_v8.py"},"GET /api/download/soma.zip":{"auth":false,"returns":"bundle: soma.py, requirements.txt, README.md, soma_v8_spec.md"},"GET /api/download/paper.pdf":{"auth":false},"GET /api/site-info":{"auth":false,"returns":"lightweight site metadata"},"GET /api/robots.txt":{"auth":false}},"checkpoint_schema":{"compatibility":"two checkpoints are composable iff n_bands, hidden_dim, base, and direct_readout all match exactly.","identity":"checkpoint_id is a sha256 over weights + traces + fixed config. unfakeable.","lineage":"checkpoint_history is an ordered list of declared ancestor ids, oldest first. self-reported by the uploader; not cryptographically verified.","file_format":".pt (pytorch). load with torch.load(path, weights_only=False, mmap=True).","max_upload_size":"16 GB"},"soma":{"what":"a continual-learning architecture: exponentially decayed byte traces at geometrically spaced timescales (default φ = 1.618), feeding a small MLP readout. trains one byte at a time from any stream. fixed memory regardless of stream length.","modes":["train","eval","chat"],"runtime":"python 3.8+, pytorch, numpy. cpu/cuda/mps auto-detected. one script.","where_to_get_it":"https://logossoma.com/api/download/soma.py","full_spec":"https://logossoma.com/specs"}}