AgenticLocal/docs/index.html at 7c1505861999b11a70824fb1135fad66b9479731 · Bowen-AI/AgenticLocal · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>AgenticLocal</title>
    <meta
      name="description"
      content="AgenticLocal is a local-first agent runtime with tools, workspace policy, durable SQLite state, event streams, and provider-swappable model adapters."
    >
    <meta name="robots" content="index,follow,max-snippet:-1,max-image-preview:large">
    <meta name="googlebot" content="index,follow,max-snippet:-1,max-image-preview:large">
    <meta name="google-site-verification" content="aOBPWfdIMvfVZ9nvI3cEKqeC5sh6ztQ5HINFHwpk1fo" />
    <meta
      name="keywords"
      content="AgenticLocal, local-first AI agent, agentic AI runtime, Python agent framework, local AI assistant, tool-using agent, SQLite agent memory, Ollama agent, OpenAI-compatible agent runtime"
    >
    <link rel="canonical" href="https://bowen-ai.github.io/AgenticLocal/">
    <link rel="sitemap" type="application/xml" href="https://bowen-ai.github.io/AgenticLocal/sitemap.xml">
    <meta property="og:site_name" content="AgenticLocal">
    <meta property="og:title" content="AgenticLocal">
    <meta
      property="og:description"
      content="A local-first agent runtime for tool use, workspace policy, durable memory, event streams, voice, and provider adapters."
    >
    <meta property="og:type" content="website">
    <meta name="author" content="Bowen AI">
    <meta property="og:url" content="https://bowen-ai.github.io/AgenticLocal/">
    <meta property="og:image" content="https://bowen-ai.github.io/AgenticLocal/assets/screenshots/voice-mode.svg">
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:title" content="AgenticLocal">
    <meta
      name="twitter:description"
      content="A local-first Python agent runtime with tools, policy, memory, event streams, voice, and swappable model adapters."
    >
    <meta name="twitter:image" content="https://bowen-ai.github.io/AgenticLocal/assets/screenshots/voice-mode.svg">
    <meta name="theme-color" content="#111827">
    <link rel="stylesheet" href="site.css">
    <script type="application/ld+json">
      {
        "@context": "https://schema.org",
        "@graph": [
          {
            "@type": "WebSite",
            "name": "AgenticLocal",
            "url": "https://bowen-ai.github.io/AgenticLocal/",
            "description": "Local-first agent runtime with tools, policy, memory, event streams, voice, and provider-swappable model adapters."
          },
          {
            "@type": "Person",
            "name": "Bowen",
            "url": "https://bowenislandsong.github.io/#/personal",
            "sameAs": ["https://github.com/Bowen-AI"]
          },
          {
            "@type": "SoftwareSourceCode",
            "name": "AgenticLocal",
            "description": "A dependency-free Python implementation of a local-first agentic AI runtime with tool use, policy checks, SQLite memory, event streams, and provider adapters.",
            "url": "https://bowen-ai.github.io/AgenticLocal/",
            "codeRepository": "https://github.com/Bowen-AI/AgenticLocal",
            "programmingLanguage": "Python",
            "runtimePlatform": "Python 3.11+",
            "applicationCategory": "DeveloperApplication"
          }
        ]
      }
    </script>
  </head>
  <body>
    <header class="site-header">
      <a class="brand" href="#top" aria-label="AgenticLocal home">
        <span class="brand-mark" aria-hidden="true">AL</span>
        <span>AgenticLocal</span>
      </a>
      <nav class="nav" aria-label="Project navigation">
        <a href="#demo">Demo</a>
        <a href="#runtime">Runtime</a>
        <a href="#use-cases">Use Cases</a>
        <a href="#about">About</a>
        <a href="install.html">Install</a>
        <a href="github-pages.html">Deploy</a>
      </nav>
    </header>

    <main id="top">
      <section class="hero" aria-labelledby="hero-title">
        <div class="hero-media" aria-hidden="true">
          <img src="assets/screenshots/voice-mode.svg" alt="">
        </div>
        <div class="hero-copy">
          <p class="eyebrow">Local-first agent runtime</p>
          <h1 id="hero-title">AgenticLocal</h1>
          <p class="lede">
            A small, inspectable agent loop with tools, workspace policy, durable
            SQLite state, streaming events, voice, and runtime-selectable model adapters.
          </p>
          <div class="hero-actions" aria-label="Primary links">
            <a class="button primary" href="install.html">Install</a>
            <a class="button secondary" href="https://github.com/Bowen-AI/AgenticLocal" rel="noopener" target="_blank">Open Source on GitHub</a>
            <a class="button secondary" href="example-screenshots.html">Screenshots</a>
          </div>
        </div>
      </section>

      <section class="quickstart" aria-labelledby="quickstart-title">
        <div class="section-heading">
          <p class="eyebrow">Try it locally</p>
          <h2 id="quickstart-title">Install and start exploring</h2>
        </div>
        <pre class="terminal" aria-label="Quickstart command"><code>curl -fsSL https://raw.githubusercontent.com/Bowen-AI/AgenticLocal/main/scripts/install.sh \
  | bash -s -- --with-ollama
agentic-loop chat --enable-network-tools</code></pre>
      </section>

      <section id="demo" class="showcase" aria-labelledby="demo-title">
        <div class="section-heading">
          <p class="eyebrow">What it looks like</p>
          <h2 id="demo-title">CLI, voice, and event streams on the same runtime</h2>
        </div>
        <div class="screenshot-grid">
          <article class="screenshot-item">
            <img src="assets/screenshots/cli-chat.svg" alt="Terminal chat using network tools">
            <h3>Terminal chat</h3>
            <p>Continuous local chat with file, memory, date/time, web, news, and fetch tools.</p>
          </article>
          <article class="screenshot-item">
            <img src="assets/screenshots/event-stream.svg" alt="Event stream and registry views">
            <h3>Streaming events</h3>
            <p>Run, model, tool, approval, memory, and final-answer events persisted to SQLite.</p>
          </article>
        </div>
      </section>

      <section id="runtime" class="runtime" aria-labelledby="runtime-title">
        <div class="section-heading">
          <p class="eyebrow">Architecture</p>
          <h2 id="runtime-title">Built around the real agent loop</h2>
        </div>
        <div class="runtime-layout">
          <div class="flow" aria-label="Runtime flow">
            <div>Context Builder</div>
            <div>Brain Adapter</div>
            <div>Policy Engine</div>
            <div>Tool Registry</div>
            <div>Event Logger</div>
            <div>SQLite Storage</div>
          </div>
          <div class="runtime-copy">
            <p>
              The model chooses an action. The runtime checks policy, executes
              approved tools, records events, persists state, and feeds the
              observation back into the next step.
            </p>
            <ul class="check-list">
              <li>Named read and write roots with path escape protection.</li>
              <li>Durable sessions, memory, traces, rules, workflows, and registry metadata.</li>
              <li>Tool-call loop guard for repeated identical successful calls.</li>
              <li>Rule, Ollama, OpenAI-compatible, Gemini-compatible, and LocalAI adapter paths.</li>
              <li>Provider/model selection per run, chat request, or session.</li>
            </ul>
          </div>
        </div>
      </section>

      <section id="use-cases" class="use-cases" aria-labelledby="use-cases-title">
        <div class="section-heading">
          <p class="eyebrow">Use cases</p>
          <h2 id="use-cases-title">Practical local workflows</h2>
        </div>
        <div class="case-grid">
          <article>
            <h3>Workspace assistant</h3>
            <p>Inspect files, read notes, and write safe outputs under configured roots.</p>
          </article>
          <article>
            <h3>Dataset triage</h3>
            <p>Preview CSV columns, row counts, missing values, and numeric ranges.</p>
          </article>
          <article>
            <h3>Research and news</h3>
            <p>Opt into web search, Google News RSS search, and URL fetching.</p>
          </article>
          <article>
            <h3>Voice companion</h3>
            <p>Use the browser voice page now; plug in realtime voice adapters later.</p>
          </article>
        </div>
        <p class="section-link">
          <a href="use-cases.html">Open the full use case guide</a>
        </p>
      </section>


      <section id="about" class="about" aria-labelledby="about-title">
        <div class="section-heading">
          <p class="eyebrow">About us</p>
          <h2 id="about-title">Built by Bowen AI</h2>
        </div>
        <p class="about-copy">
          AgenticLocal is created and maintained by Bowen. Learn more about the builder and background on the
          personal page.
        </p>
        <p class="section-link">
          <a href="https://bowenislandsong.github.io/#/personal" rel="noopener" target="_blank">Meet Bowen and read the personal profile</a>
        </p>
      </section>

      <section class="docs-band" aria-labelledby="docs-title">
        <div class="section-heading">
          <p class="eyebrow">Docs</p>
          <h2 id="docs-title">Everything needed to show the project</h2>
        </div>
        <div class="docs-links">
          <a href="install.html">Install Guide</a>
          <a href="architecture-decision.html">Architecture Decision</a>
          <a href="example-screenshots.html">Example Screenshots</a>
          <a href="github-pages.html">GitHub Pages Deploy</a>
          <a href="ollama-gemma-check.html">Ollama Gemma Check</a>
          <a href="voice-agents.html">Voice Agents</a>
        </div>
      </section>
    </main>

    <footer class="site-footer">
      <span>AgenticLocal 0.1.0</span>
      <span>Local-first. Tool-aware. Policy-checked.</span>
    </footer>
  </body>
</html>