This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
local-automata
ローカルLLM(mlx / llama.cpp)で動く、最小の汎用エージェントとサーバー。LLM とツールを組み合わせた agent loop が土台で、設定(agent.toml + 指示 AGENTS.md)だけで他のエージェントにも転用可能。
クイックスタート
uv が必要。
初回だけ環境構築が必要。
uv sync
ターミナル1: ゲートウェイ(LLM/VLMサーバー)を起動する。サーバーは別パッケージ local-llm-server で、gateway.toml(モデルカタログ)を読む。使用中サーバーは常時起動。
uv run local-llm-server
ターミナル2: チャット画面を起動する(ブラウザが開く)。
uv run local-automata-web
設定(agent.toml)
エージェントの挙動は agent.toml で決まる。model と base_url(接続先ゲートウェイ)は必須:
model = "mlx-community/Qwen3.6-27B-4bit" # 使うモデル(ゲートウェイの gateway.toml に登録)
base_url = "http://localhost:8799/v1" # 接続先ゲートウェイ
tools = ["read_file", "edit_file", "run_command"]
全キー・プロファイル・複数エージェントの設計は docs/configuration.md を参照。
LLM サーバー(ゲートウェイ)
LLM サーバーは1つのゲートウェイとして立てる。使うモデルを書いた ./gateway.toml(モデルカタログ)が必須で、model でモデルを振り分け、登録したモデルは使われた時にロードされる。(同時に載せる数は max_resident)
起動する(カレントディレクトリの ./gateway.toml を読む):
uv run local-llm-server
状態確認:
uv run local-llm-server --status
停止:
uv run local-llm-server --stop
サーバーは別パッケージ local-llm-server で、gateway.toml の書き方(提供モデル・MTP・max_resident)はそちらを参照(サンプルの gateway.toml も同梱)。接続側の概要は docs/llm-server.md を参照。
外部ツール(MCP)
agent.toml に mcp_dir のパスを設定し、そのフォルダに MCP サーバーのコードを置くだけで、エージェントが全ツールを認識し、呼び出し時に自動起動する。詳しくは docs/tools-and-mcp.md。
サンプル
examples/ に用途別のエージェント一式がある。ゲートウェイを起動してから、各ディレクトリで実行する。
| ディレクトリ | 内容 |
|---|---|
examples/character/ |
会話のみ(ツールなし)+長期メモリの「ルナ」 |
examples/coder/ |
汎用コーディングエージェント。作成・修正 → 実行 → 検証 |
examples/optimizer/ |
作成 → 実行 → 評価 → やり直しを固定ワークフローで反復 |
examples/ml/ |
CSV から前処理 → 学習 → 評価 → 保存 |
coder サンプル
cd examples/coder
GUI を起動する:
uv run local-automata-web
ドキュメント
- docs/cli.md — ターミナルで使う(
local-automata)、添付、複数エージェントの同時実行 - docs/configuration.md —
agent.toml全リファレンス、プロファイル、機能トグル(tool_mode / verbose / thinking / planning / memory) - docs/tools-and-mcp.md — 組み込みツールと安全性、MCP の探索・起動(
mcp_dir/ AIOS フォルダ方式 /mcp_mode) - docs/llm-server.md — ゲートウェイ、投機的デコード(MTP)、画像・動画(vision)、音声(voice)
- docs/workflows.md — 固定ワークフロー(YAML / Markdown)の書き方
- docs/library.md — ライブラリとして組み込む、入力アダプタ
- docs/development.md — 構成・テスト・開発
- docs/troubleshooting.md — よくある症状と対処
- SPEC.md — 挙動の詳細仕様
Metadata
Release files for local-automata 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| local_automata-0.4.0.tar.gz | 420.8 kB | Without provenance | Details for local_automata-0.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| local_automata-0.4.0-py3-none-any.whl | Python 3 | none | any | Details for local_automata-0.4.0-py3-none-any.whl |
Total release size: 836.7 kB
Release files / local_automata-0.4.0.tar.gz
| Download URL | local_automata-0.4.0.tar.gz |
|---|---|
| Size | 420.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2b510032e2aea7e6635626afdb5648aa2df2ecb5d33581279529428fa973601d
|
|
BLAKE2b-256 checksum How to use checksums |
96f7949edb9eb44fb94a2c9ff1f40dcea68f92e7d89d6cabd679d4c171258c37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.10
|
Release files / local_automata-0.4.0-py3-none-any.whl
| Download URL | local_automata-0.4.0-py3-none-any.whl |
|---|---|
| Size | 415.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
23f42cd10aa07b81b35044f26f94b654e05a2175385f903c5ce8c6424776a84b
|
|
BLAKE2b-256 checksum How to use checksums |
e08ff9786af74d9bd56cddfb55ef2d95cb3ac871d4b9e5b0b1bd5dd3979abc0b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.10
|
Security for local-automata 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.