local-aios 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,35 @@
1
+ # Byte-compiled / optimized
2
+ __pycache__/
3
+ *.py[cod]
4
+ *$py.class
5
+
6
+ # Build artifacts
7
+ build/
8
+ dist/
9
+ *.egg-info/
10
+ .eggs/
11
+
12
+ # Virtual environments
13
+ .venv/
14
+ venv/
15
+ env/
16
+
17
+ # uv
18
+ .uv/
19
+
20
+ # Test / coverage / type-check caches
21
+ .pytest_cache/
22
+ .mypy_cache/
23
+ .ruff_cache/
24
+ .coverage
25
+ htmlcov/
26
+
27
+ # Editor / OS
28
+ .idea/
29
+ .vscode/
30
+ .DS_Store
31
+
32
+ # Environment files (may contain tokens)
33
+ .env
34
+ .env.*
35
+ .pypirc
@@ -0,0 +1,76 @@
1
+ Metadata-Version: 2.4
2
+ Name: local-aios
3
+ Version: 0.0.1
4
+ Summary: An AI Operating System for local LLMs — register apps, and let AI agents use them.
5
+ Project-URL: Homepage, https://github.com/ToPo-ToPo-ToPo/local-aios
6
+ Project-URL: Repository, https://github.com/ToPo-ToPo-ToPo/local-aios
7
+ Author: ToPo
8
+ Keywords: agents,ai,aios,llm,local-llm,operating-system
9
+ Classifier: Development Status :: 1 - Planning
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Operating System :: OS Independent
12
+ Classifier: Programming Language :: Python :: 3
13
+ Requires-Python: >=3.9
14
+ Description-Content-Type: text/markdown
15
+
16
+ # local-AIOS
17
+
18
+ **An AI Operating System for local LLMs** — register apps, and let AI agents use them.
19
+
20
+ `local-AIOS` is a base system that turns a locally-running LLM into the core of an
21
+ operating-system-like environment. Apps are registered into the system, and AI agents
22
+ call them as needed — much like programs running on top of an OS kernel. Everything runs
23
+ on your own machine.
24
+
25
+ > **Install name:** `uv add local-aios` · **Import name:** `import local_aios`
26
+
27
+ ---
28
+
29
+ ## Why local-AIOS?
30
+
31
+ Most "AI agent OS" projects assume a cloud LLM. `local-AIOS` is built the other way around:
32
+ **local-first**. Your models, your apps, and your data stay on-device.
33
+
34
+ - **Local LLM at the core.** Designed for models you run yourself (e.g. via Ollama,
35
+ llama.cpp, or any OpenAI-compatible local endpoint). No cloud dependency required.
36
+ - **Apps as first-class citizens.** Register apps into the system; agents discover and
37
+ invoke them through a uniform interface.
38
+ - **A base system to build on.** `local-AIOS` is the foundation. Higher layers — including
39
+ a GUI — are designed to sit on top of it.
40
+ - **On-device by default.** Your prompts, files, and app data never have to leave your machine.
41
+
42
+ ---
43
+
44
+ ## Status
45
+
46
+ > ⚠️ **Early development.** APIs are not yet stable and may change. The base system is the
47
+ > current focus; the GUI layer is planned for a later stage.
48
+
49
+ ---
50
+
51
+ ## Installation
52
+
53
+ ```bash
54
+ uv add local-aios
55
+ ```
56
+
57
+ ## How is this different from other "AIOS" projects?
58
+
59
+ There are several projects exploring the "AI as an operating system" idea. `local-AIOS`
60
+ is specifically a **local-first base system**: it targets self-hosted LLMs running
61
+ on-device, and is intended as a foundation that a GUI and higher-level apps are built on
62
+ top of. If you're looking for a cloud-oriented agent platform, other projects may fit
63
+ better — `local-AIOS` is for keeping the whole stack on your own machine.
64
+
65
+ ---
66
+
67
+ ## Contributing
68
+
69
+ Contributions are welcome. Since the project is in early development, opening an issue to
70
+ discuss a change before submitting a large pull request is appreciated.
71
+
72
+ ---
73
+
74
+ ## License
75
+
76
+ TBD — add your chosen license here (e.g. MIT, Apache-2.0) before publishing.
@@ -0,0 +1,61 @@
1
+ # local-AIOS
2
+
3
+ **An AI Operating System for local LLMs** — register apps, and let AI agents use them.
4
+
5
+ `local-AIOS` is a base system that turns a locally-running LLM into the core of an
6
+ operating-system-like environment. Apps are registered into the system, and AI agents
7
+ call them as needed — much like programs running on top of an OS kernel. Everything runs
8
+ on your own machine.
9
+
10
+ > **Install name:** `uv add local-aios` · **Import name:** `import local_aios`
11
+
12
+ ---
13
+
14
+ ## Why local-AIOS?
15
+
16
+ Most "AI agent OS" projects assume a cloud LLM. `local-AIOS` is built the other way around:
17
+ **local-first**. Your models, your apps, and your data stay on-device.
18
+
19
+ - **Local LLM at the core.** Designed for models you run yourself (e.g. via Ollama,
20
+ llama.cpp, or any OpenAI-compatible local endpoint). No cloud dependency required.
21
+ - **Apps as first-class citizens.** Register apps into the system; agents discover and
22
+ invoke them through a uniform interface.
23
+ - **A base system to build on.** `local-AIOS` is the foundation. Higher layers — including
24
+ a GUI — are designed to sit on top of it.
25
+ - **On-device by default.** Your prompts, files, and app data never have to leave your machine.
26
+
27
+ ---
28
+
29
+ ## Status
30
+
31
+ > ⚠️ **Early development.** APIs are not yet stable and may change. The base system is the
32
+ > current focus; the GUI layer is planned for a later stage.
33
+
34
+ ---
35
+
36
+ ## Installation
37
+
38
+ ```bash
39
+ uv add local-aios
40
+ ```
41
+
42
+ ## How is this different from other "AIOS" projects?
43
+
44
+ There are several projects exploring the "AI as an operating system" idea. `local-AIOS`
45
+ is specifically a **local-first base system**: it targets self-hosted LLMs running
46
+ on-device, and is intended as a foundation that a GUI and higher-level apps are built on
47
+ top of. If you're looking for a cloud-oriented agent platform, other projects may fit
48
+ better — `local-AIOS` is for keeping the whole stack on your own machine.
49
+
50
+ ---
51
+
52
+ ## Contributing
53
+
54
+ Contributions are welcome. Since the project is in early development, opening an issue to
55
+ discuss a change before submitting a large pull request is appreciated.
56
+
57
+ ---
58
+
59
+ ## License
60
+
61
+ TBD — add your chosen license here (e.g. MIT, Apache-2.0) before publishing.
@@ -0,0 +1,29 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "local-aios"
7
+ version = "0.0.1"
8
+ description = "An AI Operating System for local LLMs — register apps, and let AI agents use them."
9
+ readme = "README.md"
10
+ requires-python = ">=3.9"
11
+ authors = [{ name = "ToPo" }]
12
+ keywords = ["ai", "agents", "llm", "local-llm", "operating-system", "aios"]
13
+ classifiers = [
14
+ "Development Status :: 1 - Planning",
15
+ "Intended Audience :: Developers",
16
+ "Programming Language :: Python :: 3",
17
+ "Operating System :: OS Independent",
18
+ ]
19
+ dependencies = []
20
+
21
+ [project.urls]
22
+ Homepage = "https://github.com/ToPo-ToPo-ToPo/local-aios"
23
+ Repository = "https://github.com/ToPo-ToPo-ToPo/local-aios"
24
+
25
+ [tool.hatch.build.targets.wheel]
26
+ packages = ["src/local_aios"]
27
+
28
+ [tool.hatch.build.targets.sdist]
29
+ only-include = ["src/local_aios", "README.md", "pyproject.toml"]
@@ -0,0 +1,7 @@
1
+ """local-AIOS — An AI Operating System for local LLMs.
2
+
3
+ This is an early placeholder release reserving the project name on PyPI.
4
+ The implementation is under active development.
5
+ """
6
+
7
+ __version__ = "0.0.1"