Metadata-Version: 2.4
Name: astra-framework
Version: 0.1.1
Summary: Astra Framework - Core APIs and abstractions for building AI agents, teams, RAG pipelines, and workflows
Project-URL: Homepage, https://github.com/HeeManSu/astra-agi
Project-URL: Documentation, https://github.com/HeeManSu/astra-agi#readme
Project-URL: Repository, https://github.com/HeeManSu/astra-agi
Project-URL: Issues, https://github.com/HeeManSu/astra-agi/issues
Author-email: Himanshu Sharma <himanshu.kumarr07@gmail.com>
License: MIT
License-File: LICENSE
Keywords: agents,ai,ai-agents,framework,langchain-alternative,llm,multi-agent,rag,retrieval-augmented-generation
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.10
Requires-Dist: accelerate>=0.26.0
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: astra-observability>=0.1.0
Requires-Dist: google-genai>=1.0.0
Requires-Dist: greenlet>=3.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: huggingface-hub>=0.20.0
Requires-Dist: lancedb>=0.4.0
Requires-Dist: motor>=3.3.0
Requires-Dist: openai>=1.0.0
Requires-Dist: pyarrow>=14.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: tiktoken>=0.5.0
Requires-Dist: torch>=2.0.0
Requires-Dist: transformers>=4.37.0
Provides-Extra: all
Requires-Dist: aioboto3>=12.0.0; extra == 'all'
Requires-Dist: beanie>=1.24.0; extra == 'all'
Requires-Dist: boto3>=1.35.0; extra == 'all'
Requires-Dist: motor>=3.3.0; extra == 'all'
Provides-Extra: aws
Requires-Dist: aioboto3>=12.0.0; extra == 'aws'
Requires-Dist: boto3>=1.35.0; extra == 'aws'
Provides-Extra: mongodb
Requires-Dist: beanie>=1.24.0; extra == 'mongodb'
Requires-Dist: motor>=3.3.0; extra == 'mongodb'
Description-Content-Type: text/markdown

# Astra Framework

🧠 **Core framework for building AI agents, teams, and RAG pipelines.**

This is the foundational layer of Astra - providing all the building blocks for intelligent AI applications.

## Installation

```bash
pip install astra-framework
```

### Optional Dependencies

```bash
# With MongoDB support
pip install astra-framework[mongodb]

# With AWS Bedrock support
pip install astra-framework[aws]

# Everything
pip install astra-framework[all]
```

## Features

| Component         | Description                                            |
| ----------------- | ------------------------------------------------------ |
| 🤖 **Agents**     | Intelligent agents with tools, memory, and context     |
| 📚 **RAG**        | Retrieval-Augmented Generation pipelines               |
| 🗄️ **Storage**    | LibSQL, MongoDB backends                               |
| 🛡️ **Guardrails** | PII filtering, content moderation, injection detection |
| 🔧 **Tools**      | Function calling with `@tool` decorator                |
| 👥 **Teams**      | Multi-agent collaboration and delegation               |
| 💾 **Memory**     | Short-term and long-term agent memory                  |
| 🔌 **Middleware** | Input/output processing pipelines                      |

## Model Support

- Google Gemini
- OpenAI GPT
- AWS Bedrock (Claude, etc.)
- HuggingFace Local Models

## Quick Example

```python
from framework.agents import Agent, tool
from framework.models import Gemini

@tool
def get_weather(city: str) -> str:
    """Get weather for a city."""
    return f"Sunny in {city}"

agent = Agent(
    model=Gemini("gemini-2.0-flash"),
    instructions="You are a helpful assistant",
    tools=[get_weather]
)

response = await agent.invoke("What's the weather in Tokyo?")
```

## Documentation

See [examples](https://github.com/HeeManSu/astra-agi/tree/main/packages/framework/examples) for comprehensive examples.

## Related Packages

- **astra-runtime**: High-level runtime with embedded mode and FastAPI server
- **astra-observability**: Tracing, metrics, and logging

## License

MIT License
