Jev Social
Jev Social is an open-source, local-first Instagram, TikTok, and LinkedIn research app from socai-io.
Overview
Jev Social pairs a System One decision provider with the socai CLI. You state a research goal; each loop rebuilds a finite menu of read-only socai commands (search, open a discovered profile or post, read comments, inspect state, finish, or download selected TikTok media only when the goal explicitly requests it). The provider selects the next operation; socai executes in the user's Chrome and returns structured observations. The UI stores choice, confidence, command, summary, and timing per step, then compiles cards, tables, and an evidence report with source links.
Problem: Social research agents often free-form shell commands or opaque browser macros, which is risky on logged-in Instagram, TikTok, and LinkedIn sessions.
Built for: Analysts and builders who want local-first social evidence gathering with auditable steps and cited Markdown output.
First indexed on Jev Directory: 2026-09-20
Creator and team
- Name
- socai
- Organization
- socai
- Handle
- @Asklv123123123
How Jev is used
- Role in the product flow
- Per-step routing over a dynamic catalog of socai CLI operations
- Primitives
- Choice
- State in
- User goal, platform context, history of prior operations with observed summaries, and enumerated command targets derived from captured results or explicit URLs.
- Decision out
- Next allowed socai command or finish; confidence recorded per README. Unsupported, malformed, and low-confidence decisions do not run; failed ops are removed from the next choice set.
- Build bounded operation list from socai capabilities and prior results
- Jev Choice picks platform (auto mode) then next operation
- socai CLI runs read-only command in Chrome
- Append observation and repeat until finish or max-steps
- Compile cited Markdown report from captured text and links
Jev never emits arbitrary shell commands or DOM coordinates. It only chooses among commands the app exposes, matching the Browser Use pattern of finite actions over structured state. Confidence and policy live in application code: sub-threshold or invalid picks are dropped before socai runs. The released provider boundary supports OpenRouter Jev or an explicit loopback /v1/systemone endpoint; the local path rejects redirects and never receives the OpenRouter key. Step limits (--max-steps, default 12) bound cost while partial results remain honest when login walls or decision failures appear. Jev Social v0.1.10 starts each socai child with telemetry disabled unless the exact value SOCAI_TELEMETRY=1 opts in.
Features and stack
Features
- Instagram, TikTok, and LinkedIn operation tables in README
- Release-pinned npx github:socai-io/jev-social#v0.1.10 onboarding without cloning
- Loopback web UI at 127.0.0.1:8766 plus CLI search mode
- Per-step run trace: choice, confidence, command, summary, and elapsed time
- Marketing site and GIF demos linked from repository
Stack
- Node 20+
- socai CLI (Chrome automation)
- System One via OpenRouter Jev or an explicit loopback endpoint
- JavaScript
Pricing: Open source; OpenRouter usage bills to your key when selected. A compatible loopback provider needs no OpenRouter key, while browser and social-platform access still apply. No mock result is substituted when the decision provider is unavailable.
Links
FAQ
- Does Jev Social run in the cloud?
- No. The app is local-first with a loopback UI. socai drives your Chrome; README states reports compile from captured evidence without handing browsing to another agent.
- What happens on low confidence?
- README: unsupported, malformed, and low-confidence decisions do not execute. The next choice set also omits previously attempted operations.
- Which platforms are supported?
- Instagram, TikTok, and LinkedIn via socai commands documented in the Available operations table. Only installed socai CLI commands appear as Jev choices.
- How do I try it quickly?
- Run npx github:socai-io/jev-social#v0.1.10 onboard, then npx github:socai-io/jev-social#v0.1.10, or clone the repo and use npm start. You need Node 20+, a current socai CLI, signed-in Chrome access, and either OpenRouter Jev or a compatible loopback System One endpoint.
Related learn guides
Original Jev guidance that pairs with this product pattern.
- Jev use cases
The patterns builders actually search for: moderation, routing, triage, RAG verify, and agent gates.
- Jev vs LLM classification
When to gate with System One probabilities instead of asking a chat model to label things.
Related products
Hand-picked neighbors with rich profiles or overlapping tags.