Skip to content

Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.

15.4 KB
Raw Blame
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Jev Social — social research in your real browser</title>
    <meta name="description" content="Jev chooses bounded socai CLI operations for Instagram, TikTok, and LinkedIn, streams captured evidence, and produces cited reports in a local browser UI.">
    <meta name="theme-color" content="#ff4fc8">
    <meta property="og:type" content="website">
    <meta property="og:site_name" content="Jev Social">
    <meta property="og:title" content="Jev Social — social research in your real browser">
    <meta property="og:description" content="TypeSafe Jev chooses. socai drives your real Chrome. Evidence streams into source-linked cards and cited reports.">
    <meta property="og:url" content="https://socai-io.github.io/jev-social/">
    <meta property="og:image" content="https://socai-io.github.io/jev-social/assets/social-preview.jpg">
    <meta property="og:image:width" content="1280">
    <meta property="og:image:height" content="640">
    <meta property="og:image:alt" content="Jev Social — typed decisions, real social data">
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:title" content="Jev Social — social research in your real browser">
    <meta name="twitter:description" content="Jev × socai: bounded browser operations, streamed social evidence, cited reports.">
    <meta name="twitter:image" content="https://socai-io.github.io/jev-social/assets/social-preview.jpg">
    <meta name="twitter:image:alt" content="Jev Social — typed decisions, real social data">
    <link rel="canonical" href="https://socai-io.github.io/jev-social/">
    <link rel="sitemap" type="application/xml" href="./sitemap.xml">
    <link rel="alternate" type="text/plain" href="./llms.txt" title="Jev Social machine-readable overview">
    <link rel="icon" href="./favicon.svg" type="image/svg+xml">
    <link rel="stylesheet" href="./styles.css">
    <script type="application/ld+json">
      {
        "@context": "https://schema.org",
        "@type": "SoftwareApplication",
        "name": "Jev Social",
        "description": "Open-source social research that lets TypeSafe Jev choose bounded socai CLI operations for Instagram, TikTok, and LinkedIn in a real Chrome session.",
        "url": "https://socai-io.github.io/jev-social/",
        "codeRepository": "https://github.com/socai-io/jev-social",
        "downloadUrl": "https://github.com/socai-io/jev-social/releases/latest",
        "image": "https://socai-io.github.io/jev-social/assets/social-preview.jpg",
        "softwareVersion": "0.1.13",
        "applicationCategory": "DeveloperApplication",
        "operatingSystem": "macOS, Windows, Linux",
        "isAccessibleForFree": true,
        "license": "https://opensource.org/license/mit",
        "dateModified": "2026-09-28",
        "offers": {
          "@type": "Offer",
          "price": "0",
          "priceCurrency": "USD"
        },
        "sameAs": [
          "https://github.com/socai-io/jev-social",
          "https://ossdrop.com/tool/jev-social"
        ]
      }
    </script>
  </head>
  <body>
    <a class="skip-link" href="#main">Skip to content</a>

    <header class="site-header">
      <a class="wordmark" href="#top" aria-label="Jev Social home">
        <span class="mark" aria-hidden="true"></span>
        <span>JEV <b>×</b> socai</span>
      </a>
      <nav aria-label="Primary navigation">
        <a href="./social-research/">Social workflows ↗</a>
        <a class="star-link" href="https://github.com/socai-io/jev-social" rel="noreferrer">Star on GitHub ★</a>
      </nav>
    </header>

    <main id="main">
      <section class="hero" id="top">
        <div class="hero-glow" aria-hidden="true"></div>
        <div class="eyebrow">JEV × socai</div>
        <h1>Social research<br><span>in your real browser.</span></h1>
        <p class="hero-copy">
          Describe an Instagram, TikTok, or LinkedIn research goal. TypeSafe Jev chooses the next bounded operation; the local socai CLI executes it in Chrome; captured evidence streams into cards and a cited report.
        </p>
        <ul class="platforms">
          <li><img src="./assets/platforms/instagram.png" alt="">Instagram</li>
          <li><img src="./assets/platforms/tiktok.png" alt="">TikTok</li>
          <li><img src="./assets/platforms/linkedin.svg" alt="">LinkedIn</li>
        </ul>
        <div class="hero-actions">
          <a class="button button-dark" href="#run">Run it locally ↓</a>
          <a class="button button-light" href="./recorded-run/">Watch a recorded run ▶</a>
          <a class="button button-light" href="https://github.com/socai-io/jev-social" rel="noreferrer">View source ↗</a>
        </div>
        <p class="trust-line">
          Local UI · real CLI calls · no mock fallback · MIT licensed ·
          <a href="https://ossdrop.com/tool/jev-social" rel="noreferrer">#1 Tool of the Day on OSSDrop ↗</a>
        </p>
      </section>

      <section class="category reveal" aria-labelledby="category-heading">
        <div>
          <div class="section-label">DECISION APIS JUST WENT MAINSTREAM</div>
          <h2 id="category-heading">The API decides.<br>The browser still has to prove it.</h2>
        </div>
        <div class="category-card">
          <p><a href="https://openai.com/zh-Hans-CN/index/devday-2026-recap/" rel="noreferrer">OpenAI introduced the Decisions API at DevDay 2026 ↗</a>, widening the category beyond Jev.</p>
          <p><strong>Jev Social currently uses TypeSafe Jev through OpenRouter.</strong> OpenAI Decisions API support is not yet wired; compatibility will only be claimed after its public contract can be tested end to end.</p>
          <p class="category-loop"><span>typed decision</span><i aria-hidden="true">→</i><span>socai action</span><i aria-hidden="true">→</i><span>browser evidence</span></p>
        </div>
      </section>

      <section class="demo reveal" aria-labelledby="demo-heading">
        <div class="section-label">THE DEMO</div>
        <div class="section-heading">
          <h2 id="demo-heading">One goal. Visible evidence.</h2>
          <p>The recording is at 1× speed. Current builds also show every operation Jev chooses.</p>
        </div>
        <a class="demo-frame" href="./recorded-run/" aria-label="Watch a sanitized recorded Jev Social run">
          <img src="./assets/jev-social.gif" alt="Jev Social local demo routing a goal to socai and streaming captured post cards">
          <span>Replay one audited run ↗</span>
        </a>
      </section>

      <section class="flow reveal" aria-labelledby="flow-heading">
        <div class="section-label">THE LOOP</div>
        <div class="section-heading compact">
          <h2 id="flow-heading">Jev decides. socai acts.</h2>
          <p>The model never writes shell commands or arbitrary selectors.</p>
        </div>
        <ol class="flow-grid">
          <li>
            <span class="step">01</span>
            <h3>Route the goal</h3>
            <p>Jev selects Instagram, TikTok, or LinkedIn from a typed choice.</p>
          </li>
          <li>
            <span class="step">02</span>
            <h3>Choose one operation</h3>
            <p>Search, open an observed post or profile, read comments, download selected video, or finish.</p>
          </li>
          <li>
            <span class="step">03</span>
            <h3>Run the real CLI</h3>
            <p>socai drives your existing Chrome session and returns structured evidence.</p>
          </li>
          <li>
            <span class="step">04</span>
            <h3>Stream the result</h3>
            <p>Post cards stay visible while Jev evaluates the new state and builds the final report.</p>
          </li>
        </ol>
      </section>

      <section class="proof reveal" aria-labelledby="proof-heading">
        <div class="proof-copy">
          <div class="section-label">WHY JEV FITS</div>
          <h2 id="proof-heading">A changing decision space, not a blank check.</h2>
          <p>Every step offers only operations supported by the installed socai CLI and only targets observed in captured results. Attempted actions disappear from the next choice set.</p>
          <ul>
            <li>Low-confidence and malformed decisions do not execute.</li>
            <li>Login gates and step limits preserve honest partial results.</li>
            <li>Sources, comments, media, and timing remain inspectable.</li>
          </ul>
        </div>
        <figure class="terminal-card" aria-label="Example Jev operation loop">
          <div class="terminal-bar"><i></i><i></i><i></i><span>jev-social</span></div>
          <pre><code><span class="muted">goal</span>  find emerging design creators

<span class="pink">jev</span>   instagram.search
<span class="blue">socai</span> captured 4 post cards

<span class="pink">jev</span>   instagram.read_post [2]
<span class="blue">socai</span> captured caption + comments

<span class="pink">jev</span>   finish
<span class="green">done</span>  source-linked report</code></pre>
        </figure>
      </section>

      <section class="evidence reveal" aria-labelledby="evidence-heading">
        <div class="section-label">RECORDED EVIDENCE</div>
        <div class="section-heading">
          <h2 id="evidence-heading">Inspect the output,<br>not a speed claim.</h2>
          <p>Three dated local observations show what was captured, how long that run took, and where the evidence is incomplete.</p>
        </div>
        <div class="evidence-grid">
          <article class="evidence-card">
            <span class="evidence-kicker">Instagram · Jev loop</span>
            <h3>4 source-linked records</h3>
            <p>Two searches and one Jev-selected post-detail read, compiled into a Markdown report.</p>
            <dl>
              <div><dt>Elapsed</dt><dd>63.969 s</dd></div>
              <div><dt>Status</dt><dd>Complete</dd></div>
            </dl>
            <a href="https://github.com/socai-io/jev-social/blob/main/docs/example-report.md" rel="noreferrer">Open the report ↗</a>
          </article>
          <article class="evidence-card">
            <span class="evidence-kicker">TikTok · socai search</span>
            <h3>5 public result URLs</h3>
            <p>A recorded CLI search with the returned post links preserved for inspection.</p>
            <dl>
              <div><dt>Elapsed</dt><dd>7.570 s</dd></div>
              <div><dt>Status</dt><dd>Complete</dd></div>
            </dl>
            <a href="https://github.com/socai-io/jev-social/blob/main/docs/tiktok-evidence.md#search" rel="noreferrer">Inspect the search ↗</a>
          </article>
          <article class="evidence-card">
            <span class="evidence-kicker">TikTok · selected video</span>
            <h3>Video and poster saved</h3>
            <p>A 7,988,959-byte MP4 and 95,592-byte poster were captured; comments were unavailable.</p>
            <dl>
              <div><dt>Elapsed</dt><dd>38.263 s</dd></div>
              <div><dt>Status</dt><dd>Partial</dd></div>
            </dl>
            <a href="https://github.com/socai-io/jev-social/blob/main/docs/tiktok-evidence.md#video-detail-and-media-download" rel="noreferrer">Inspect the media evidence ↗</a>
          </article>
        </div>
        <p class="evidence-note">These are individual local observations, not a benchmark or guaranteed latency. Live-site behavior, network conditions, login state, and Jev's selected operations change the total time. v0.1.8 adds a <a href="https://github.com/socai-io/jev-social/blob/main/benchmark/README.md" rel="noreferrer">reproducible benchmark protocol ↗</a>; no live benchmark results are published yet.</p>
      </section>

      <section class="run reveal" id="run" aria-labelledby="run-heading">
        <div class="run-copy">
          <div class="section-label">RUN LOCALLY</div>
          <h2 id="run-heading">Your browser. Your session. Your evidence.</h2>
          <p>The tagged release uses OpenRouter Jev by default and can route decisions through a loopback Kev server without an OpenRouter key. Both paths keep browser execution inside the socai runtime and the user's Chrome session.</p>
          <p>With the default OpenRouter provider, onboarding prompts for the OpenRouter key. On macOS and Windows, onboarding can also install the official socai CLI when it is missing. On Linux, install a current socai CLI from source first, then put it on PATH or set SOCAI_BIN.</p>
        </div>
        <div class="code-block">
          <div class="code-label">TERMINAL</div>
          <pre><code><span>npx github:socai-io/jev-social#v0.1.13 onboard</span>
<span>npx github:socai-io/jev-social#v0.1.13</span></code></pre>
        </div>
        <div class="run-actions">
          <a class="button button-pink" href="https://github.com/socai-io/jev-social" rel="noreferrer">Star Jev Social ★</a>
          <a class="text-link" href="./social-research/">Explore social workflows ↗</a>
          <a class="text-link" href="./privacy/">Privacy and data flow ↗</a>
          <a class="text-link" href="./local-system-one/">Run with local System One ↗</a>
          <a class="text-link" href="https://github.com/socai-io/jev-social#run-it" rel="noreferrer">Install for Codex, OpenCode, or OpenClaw ↗</a>
          <a class="text-link" href="https://skills.sh/socai-io/jev-social/jev-social" rel="noreferrer">Browse the Agent Skill on skills.sh ↗</a>
        </div>
      </section>

      <section class="share reveal" aria-labelledby="share-heading">
        <div>
          <div class="section-label">PASS IT ON</div>
          <h2 id="share-heading">Social research should show its work.</h2>
        </div>
        <div class="share-panel">
          <p>Know someone building browser agents, creator research, or social intelligence? Send them the open-source demo.</p>
          <nav class="share-links" aria-label="Share Jev Social">
            <a href="https://x.com/intent/tweet?text=Jev%20Social%3A%20Jev%20chooses%20bounded%20social%20research%20steps%2C%20socai%20runs%20them%20in%20your%20real%20browser%2C%20and%20the%20evidence%20streams%20into%20a%20cited%20report.&amp;url=https%3A%2F%2Fsocai-io.github.io%2Fjev-social%2F" target="_blank" rel="noopener noreferrer">Share on X ↗</a>
            <a href="https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fsocai-io.github.io%2Fjev-social%2F" target="_blank" rel="noopener noreferrer">Share on LinkedIn ↗</a>
            <a href="https://www.reddit.com/submit?url=https%3A%2F%2Fsocai-io.github.io%2Fjev-social%2F&amp;title=Jev%20Social%20%E2%80%94%20social%20research%20in%20your%20real%20browser" target="_blank" rel="noopener noreferrer">Share on Reddit ↗</a>
            <a href="https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fsocai-io.github.io%2Fjev-social%2F&amp;t=Jev%20Social%20%E2%80%94%20Jev-guided%20social%20research%20in%20your%20browser" target="_blank" rel="noopener noreferrer">Submit to Hacker News ↗</a>
          </nav>
        </div>
      </section>
    </main>

    <footer>
      <span>JEV × socai</span>
      <p>Fast typed decisions meet real social browser evidence.</p>
      <div>
        <a href="https://typesafe.ai/" rel="noreferrer">TypeSafe</a>
        <a href="./social-research/">Workflows</a>
        <a href="./privacy/">Privacy</a>
        <a href="https://github.com/socai-io/jev-social" rel="noreferrer">GitHub</a>
        <a href="./llms.txt">llms.txt</a>
      </div>
    </footer>
  </body>
</html>