Metadata-Version: 2.4
Name: atlas-knowledge-sdk
Version: 0.3.1
Summary: Python SDK for the Atlas Knowledge Operating System — Terraform for AI agent knowledge
Author-email: Atlas Knowledge <varshinicb1@gmail.com>
License: MIT
Project-URL: Homepage, https://atlas-sh.pages.dev
Project-URL: Documentation, https://atlas-sh.pages.dev/docs/
Project-URL: Repository, https://github.com/varshinicb1/atlas
Keywords: atlas,knowledge,ai,agent,decision-tree
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: test
Requires-Dist: pytest>=7; extra == "test"

# Atlas Python SDK

Python SDK for the [Atlas Knowledge Operating System](https://atlas-sh.pages.dev) — the Terraform for AI agent knowledge.

```bash
pip install atlas-knowledge-sdk
```

## Quickstart

```python
import atlas_sdk as atlas

# Solve: search a knowledge bundle
result = atlas.solve("flutter_core.atlas", "stateful widget")
for node in result.nodes:
    print(node.name, node.kind)

# Decide: walk a decision tree
decision = atlas.decide("tech_stack.atlas", "build web app", context={"type": "saas"})
if decision:
    print(decision.rationale)
    for rec in decision.recommendations:
        print(f"  -> {rec.node_id} (confidence: {rec.confidence})")

# Use the Agent class for registry-backed agents
from atlas_sdk import Agent
agent = Agent("my-agent", packages=["flutter_core", "riverpod"])
result = agent.solve("How to use AsyncNotifier?")
```

## Documentation

See the [full API reference](https://atlas-sh.pages.dev/docs/api.html) and [quickstart guide](https://atlas-sh.pages.dev/docs/quickstart.html).

## License

Apache 2.0

