
2026/03/22 4:31
**HNに投稿:Atomic ― セマンティックに結びついた自己ホスト型パーソナル知識ベース**
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Atomic は、プレーンな Markdown ノートを「アトム」と呼ばれる意味的にリンクされたグラフへ変換するオープンソースの個人知識ベースプラットフォームです。各アトムはチャンク化・埋め込み済みのコンテンツ片を格納し、意味的類似性によって自動でタグ付けおよびリンクされます。
主な機能には、ベクトル検索(sqlite‑vec)、引用付き LLM 生成ウィキ合成、エージェント型 RAG チャット、自動タグ付け、RSS フィード同期、および視覚探索用のフォースダイレクテッドキャンバスが含まれます。AI 統合は OpenRouter やローカル Ollama モデルなど複数プロバイダーをサポートし、セットアップウィザードまたは設定から構成可能です。
Atomic は以下のモードで動作します:Tauri(React/TypeScript)で構築されたデスクトップアプリ、ヘッドレス Docker/Fly.io サーバー、あるいは同時に両方。GitHub リリース、Docker Compose、Fly.io デプロイメント、Cargo からもインストール可能です。Chromium ベースのブラウザ拡張機能はウェブコンテンツをオフラインでアトムとしてキャプチャし、サーバーが到達可能な際に同期します。
プロジェクト構成ではビジネスロジックを Rust クレート
atomic-core に分離し、以下のクライアントプロジェクトを持ちます:src-tauri(デスクトップ)、atomic-server(REST + WebSocket)、atomic-mcp(Claude など他 AI 用 stdio)、および iOS SwiftUI アプリ。MCP エンドポイント(/mcp)は semantic_search、read_atom、create_atom などのツールを公開します。Atomic は MIT ライセンスで提供され、SQLite を超える複数データベースに対応し、開発には Node.js ≥22 と Rust ツールチェーンが必要です。
本文
Atomic – セマンティックに結びついた知識ベース
Atomic は Markdown ノートをリンクされた知識グラフへ変換し、探索・検索・AI による自動拡張が可能です。
コアコンセプト
| 機能 | 説明 |
|---|---|
| Atoms | Markdown ノートをチャンク化、埋め込み、タグ付けし、意味的類似性で自動リンクします。 |
| Semantic Search | SQLite + を使ったベクトル検索。 |
| Canvas | セマンティック類似度に基づくフォース・ディレクテッド可視化。 |
| Wiki Synthesis | LLM で生成した記事(インライン引用付き)が Atom から構築されます。 |
| Chat | RAG による対話型検索インターフェース。 |
| Auto‑Tagging | LLM が階層タグを抽出します。 |
| Multiple AI Providers | OpenRouter(クラウド)または Ollama(ローカル)が埋め込み・タグ付け・Wiki 生成・チャットに利用できます。 |
| RSS Feeds | フィード購読時、新しい記事が Atom として自動同期。 |
| Browser Extension | Web コンテンツを直接 Atomic に取り込む拡張機能。 |
| MCP Server | を介し Claude などの AI ツールに知識ベースを公開。 |
| Multi‑Database | 共通レジストリで複数のデータベースを共有。 |
| iOS App | SwiftUI ネイティブクライアントでモバイルから Atom の閲覧・作成が可能。 |
はじめに
1. インストール方法を選択
-
デスクトップアプリ(Tauri)
# GitHub Releases から最新版をダウンロード: # macOS, Linux, Windows -
ヘッドレスサーバー
- Docker / Fly.io
git clone https://github.com/kenforthewin/atomic.git cd atomic docker compose up -d # API サーバー + Web フロントエンドを起動 - Cargo 単体
cargo run -p atomic-server -- --data-dir ./data serve --port 8080
- Docker / Fly.io
2. 初期設定
アプリを開くか
http://localhost にアクセスし、セットアップウィザードで:
- AI プロバイダーの構成
- API トークン生成(例:
)cargo run -p atomic-server -- --data-dir ./data token create --name default
AI プロバイダー設定
| プロバイダー | 使用方法 |
|---|---|
| OpenRouter (クラウド) | から API キーを取得。埋め込み・タグ付け・Wiki 生成・チャット用に別々のモデルを設定。 |
| Ollama (ローカル) | Ollama をインストールし、モデルをプル(例:)。Atomic が利用可能なモデルを自動検出します。 |
ブラウザ拡張機能
- Chrome/Edge/Brave →
chrome://extensions - Developer mode を有効化
- Load unpacked で拡張フォルダを選択
- 拡張オプションでサーバー URL と API トークンを設定
キャプチャはオフラインキューに保存され、サーバーが接続可能になると同期します。
MCP サーバー(Claude 連携)
- エンドポイント:
(例:/mcp
)http://localhost:8080/mcp - Claude Desktop 設定 (
):~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "atomic": { "url": "http://localhost:44380/mcp" } } }
利用可能ツール:
semantic_search, read_atom, create_atom.
アーキテクチャ概要
+------------------+ | atomic-core | ← ビジネスロジック全体 +--------+---------+ | +--------v---------+ +---------------+ +-----------+ | src-tauri (desktop) | |atomic-server | |atomic-mcp| | (Tauri) | |(REST + WS) | |(stdio) | +-------------------+ +------+-------+ +----------+ | | +-----v-----+ +----v--------+ | React UI | | HTTP clients| | (web/iOS) | | (iOS, web) | +-----------+ +-------------+
プロジェクト構成
– ワークスペースルートCargo.toml
– コアロジックcrates/atomic-core/
– REST + WebSocket サーバーcrates/atomic-server/
– 独立した MCP サーバー(stdio)crates/atomic-mcp/
– HTTP‑to‑stdio ブリッジcrates/mcp-bridge/
– Tauri デスクトップアプリsrc-tauri/
– React フロントエンド (TypeScript)src/
– ネイティブ iOS アプリ (SwiftUI)ios/
– ブラウザ拡張機能extension/
– インポート & ユーティリティスクリプトscripts/
開発環境
必要条件
- Node.js ≥22
- Rust ツールチェーン (
)rustup - デスクトップ用 Tauri v2 の依存関係(OS別)
コマンド
# フロントエンドの依存をインストール npm install # デスクトップアプリ npm run tauri dev # 開発モードでホットリロード npm run tauri build # 本番ビルド # サーバーのみ cargo run -p atomic-server -- serve --port 8080 # フロントエンドのみ npm run dev # Vite デベロップメントサーバ # チェック cargo check cargo test npx tsc --noEmit
テックスタック
| レイヤー | 技術 |
|---|---|
| Core | Rust, SQLite + sqlite-vec, Tokio |
| Desktop | Tauri v2 |
| Server | actix‑web |
| Frontend | React 18, TypeScript, Vite 6, Tailwind CSS v4, Zustand 5 |
| エディタ | CodeMirror 6 |
| Canvas | d3-force, react‑zoom‑pan‑pinch |
| iOS | SwiftUI, XcodeGen |
| AI | OpenRouter または Ollama(プラグイン可能) |
ライセンス
MIT