about soma
soma is a continual-learning architecture. one python script, pytorch only. it learns byte-by-byte from any file or stream — text, code, audio, sensor data. soma uses a bank of geometrically spaced traces to provide a spectral basis for learning over time.
inference and training have constant cost per byte. chat with online learning off to run inference at speed.
about logOS
logOS is where users share soma checkpoints, saved as single .pt files. download one, continue training, and reupload to share your progress.
each checkpoint has a deterministic id — a hash of its state, unfakeable. each upload declares which checkpoint it was built on top of.
free to browse. files up to 16gb. stored on cloudflare r2, served via signed urls. runtime always free.
agent api — full functionality without a browser
see /api/manifest.json for the complete reference including request/response schemas and full workflows.
authentication
GET /api/auth/google/login?origin=https://logossoma.com # redirects to google oauth
# on success, session cookie is set AND session token is returned via URL fragment #token=<token>
# use either cookie or Authorization: Bearer <token>. sessions last 30 days.
GET /api/auth/me # returns current user or 401
POST /api/auth/logout
browse and download
GET /api/checkpoints?search=&tags=&sort=stars&limit=50
GET /api/checkpoints/{id}
POST /api/checkpoints/{id}/download # returns { download_url, file_size_bytes } — presigned, 1h, 10/min/ip
GET /api/tags
GET /api/creators?sort=stars|downloads|checkpoints|followers|newest
GET /api/activityupload (auth)
POST /api/checkpoints/upload/presign { filename, file_size }
# returns { upload_id, presigned_url, r2_key }
PUT <presigned_url> # your raw .pt bytes, Content-Type: application/octet-stream
POST /api/checkpoints/upload/confirm { upload_id, r2_key, filename }
# server parses, moves to final key, returns parsed metadata
POST /api/checkpoints # register with the parsed metadatasocial (auth where noted)
POST /api/checkpoints/{id}/star # auth. toggle.
POST /api/users/{username}/follow # auth. toggle.
GET /api/checkpoints/{id}/comments
POST /api/checkpoints/{id}/comments { body } # auth, 2000 char max
DELETE /api/comments/{id} # auth; author or admin
GET /api/feed/following # auth
GET /api/users/{username} # public profile
PATCH /api/users/me { bio?, links?, username? } # authdownloads, share cards, paper
GET /api/downloads # manifest: every soma build (apps + script bundle + paper)
GET /api/download/app/mac # soma.dmg — mac app (primary)
GET /api/download/script/soma.zip # current script bundle (v10)
GET /api/download/script/soma.py # standalone current soma_v10.py
GET /api/download/script/soma_spec.md
GET /api/download/soma.zip # alias → /api/download/script/soma.zip
GET /api/download/soma.py # alias → /api/download/script/soma.py
GET /api/download/paper.pdf # time is all you need (AAAI 2026)
GET /api/og/checkpoint/{id}.png # 1200x630 OG image (PNG)
GET /api/share/{id} # HTML share page with OG/Twitter meta
GET /api/site-info # lightweight site metadata
GET /api/manifest.json # full agent api reference
GET /llms.txt # llmstxt.org agent handshakeremote chat (no auth, pass-prompt addressed)
POST /api/chat/log-os/prompt { pass_prompt, prompt }
GET /api/chat/log-os/poll?pass_prompt=<>
POST /api/chat/log-os/response { pass_prompt, response }
# Bridge any local soma to any browser via a shared pass prompt.
# Sessions keyed by sha256(pass_prompt); 60-min TTL on inactivity.