# BSS Agent
A comprehensive AI agent framework built with LangChain and LangGraph for business support systems.
## Features
- **Authentication**: Support client access via API Key.
- **Server API**:
- FastAPI-based REST API
- Support agent response streaming
- **Security**:
- Rate limiter to avoid DDOS
- Data Privacy protector
- Prompt santinizer.
- **Environment Management**: Configuration and environment handling
- **Database Integration**:
- For checkpoints
- For long memory context (store)
- Multi DB connection
- **RAGPipeline**:
- Extract data from multi sources
- Automatic create embedding model based on name
- Easy to use Vector DB
- **Core Framework**: Base agent and multi user sessions management
- **Testing**: Comprehensive unit test for all features
## Installation
### From PyPI
```bash
pip install bssagent
```
### From Source
```bash
git clone https://github.com/bssagent/bssagent.git
cd bssagent
pip install -e .
```
### Development Installation
```bash
git clone https://github.com/bssagent/bssagent.git
cd bssagent
pip install -e ".[dev]"
```
## Quick Start
```python
from bssagent.core import BSSAgent
from bssagent.environment import EnvironmentManager
# Initialize environment
env_manager = EnvironmentManager()
env_manager.load_config()
# Create agent
agent = BSSAgent(
name="business_agent",
description="Business support agent",
tools=["file_io", "api_integration", "database"]
)
# Run agent
response = agent.run("Analyze the current business metrics")
print(response)
```
## Project Structure
```
bssagent/
├── src/bssagent/
│ ├── core/ # Core agent framework
│ ├── infrastructure/ # Infrastructure management
│ ├── deployment/ # Deployment tools
│ ├── serverapi/ # API server
│ ├── security/ # Security features
│ ├── environment/ # Environment management
│ ├── mcp/ # Model Context Protocol
│ ├── tools/ # Tool ecosystem
│ ├── database/ # Database integration
│ └── shared/ # Shared utilities
├── tests/ # Test suite
├── docs/ # Documentation
├── examples/ # Usage examples
└── scripts/ # Utility scripts
```
## Configuration
Create a `.env` file in your project root:
```env
# Database
DATABASE_URL=postgresql://user:password@localhost/bssagent
# API Keys
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
# Security
SECRET_KEY=your_secret_key
JWT_SECRET=your_jwt_secret
# Infrastructure
AWS_ACCESS_KEY_ID=your_aws_key
AWS_SECRET_ACCESS_KEY=your_aws_secret
AZURE_SUBSCRIPTION_ID=your_azure_subscription
GCP_PROJECT_ID=your_gcp_project
```
## Development
### Running Tests
```bash
# Run all tests
pytest
# Run with coverage
pytest --cov=bssagent
# Run specific test categories
pytest -m unit
pytest -m integration
```
### Code Quality
```bash
# Format code
black src/ tests/
# Sort imports
isort src/ tests/
# Type checking
mypy src/
# Linting
flake8 src/ tests/
```
### Pre-commit Hooks
```bash
pre-commit install
pre-commit run --all-files
```
## Documentation
- [API Reference](https://bssagent.readthedocs.io/en/latest/api/)
- [User Guide](https://bssagent.readthedocs.io/en/latest/user_guide/)
- [Developer Guide](https://bssagent.readthedocs.io/en/latest/developer/)
- [Deployment Guide](https://bssagent.readthedocs.io/en/latest/deployment/)
## Contributing
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Support
- Documentation: https://bssagent.readthedocs.io
- Issues: https://github.com/bssagent/bssagent/issues
- Discussions: https://github.com/bssagent/bssagent/discussions
- Email: team@bssagent.com
## Changelog
See [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history.
Raw data
{
"_id": null,
"home_page": null,
"name": "bssagent",
"maintainer": "BSS Agent Team",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, agent, langchain, langgraph, business, automation",
"author": "BSS Agent Team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f7/3b/49c68fd1f2e54c1de5086f4444815d0fc23d6f9eb18c36242cb7e5f465bc/bssagent-0.1.0.tar.gz",
"platform": null,
"description": "# BSS Agent\n\nA comprehensive AI agent framework built with LangChain and LangGraph for business support systems.\n\n## Features\n- **Authentication**: Support client access via API Key.\n- **Server API**: \n - FastAPI-based REST API\n - Support agent response streaming\n- **Security**: \n - Rate limiter to avoid DDOS\n - Data Privacy protector\n - Prompt santinizer.\n- **Environment Management**: Configuration and environment handling\n- **Database Integration**:\n - For checkpoints\n - For long memory context (store)\n - Multi DB connection\n- **RAGPipeline**:\n - Extract data from multi sources\n - Automatic create embedding model based on name\n - Easy to use Vector DB\n- **Core Framework**: Base agent and multi user sessions management\n- **Testing**: Comprehensive unit test for all features\n\n## Installation\n\n### From PyPI\n\n```bash\npip install bssagent\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/bssagent/bssagent.git\ncd bssagent\npip install -e .\n```\n\n### Development Installation\n\n```bash\ngit clone https://github.com/bssagent/bssagent.git\ncd bssagent\npip install -e \".[dev]\"\n```\n\n## Quick Start\n\n```python\nfrom bssagent.core import BSSAgent\nfrom bssagent.environment import EnvironmentManager\n\n# Initialize environment\nenv_manager = EnvironmentManager()\nenv_manager.load_config()\n\n# Create agent\nagent = BSSAgent(\n name=\"business_agent\",\n description=\"Business support agent\",\n tools=[\"file_io\", \"api_integration\", \"database\"]\n)\n\n# Run agent\nresponse = agent.run(\"Analyze the current business metrics\")\nprint(response)\n```\n\n## Project Structure\n\n```\nbssagent/\n\u251c\u2500\u2500 src/bssagent/\n\u2502 \u251c\u2500\u2500 core/ # Core agent framework\n\u2502 \u251c\u2500\u2500 infrastructure/ # Infrastructure management\n\u2502 \u251c\u2500\u2500 deployment/ # Deployment tools\n\u2502 \u251c\u2500\u2500 serverapi/ # API server\n\u2502 \u251c\u2500\u2500 security/ # Security features\n\u2502 \u251c\u2500\u2500 environment/ # Environment management\n\u2502 \u251c\u2500\u2500 mcp/ # Model Context Protocol\n\u2502 \u251c\u2500\u2500 tools/ # Tool ecosystem\n\u2502 \u251c\u2500\u2500 database/ # Database integration\n\u2502 \u2514\u2500\u2500 shared/ # Shared utilities\n\u251c\u2500\u2500 tests/ # Test suite\n\u251c\u2500\u2500 docs/ # Documentation\n\u251c\u2500\u2500 examples/ # Usage examples\n\u2514\u2500\u2500 scripts/ # Utility scripts\n```\n\n## Configuration\n\nCreate a `.env` file in your project root:\n\n```env\n# Database\nDATABASE_URL=postgresql://user:password@localhost/bssagent\n\n# API Keys\nOPENAI_API_KEY=your_openai_key\nANTHROPIC_API_KEY=your_anthropic_key\n\n# Security\nSECRET_KEY=your_secret_key\nJWT_SECRET=your_jwt_secret\n\n# Infrastructure\nAWS_ACCESS_KEY_ID=your_aws_key\nAWS_SECRET_ACCESS_KEY=your_aws_secret\nAZURE_SUBSCRIPTION_ID=your_azure_subscription\nGCP_PROJECT_ID=your_gcp_project\n```\n\n## Development\n\n### Running Tests\n\n```bash\n# Run all tests\npytest\n\n# Run with coverage\npytest --cov=bssagent\n\n# Run specific test categories\npytest -m unit\npytest -m integration\n```\n\n### Code Quality\n\n```bash\n# Format code\nblack src/ tests/\n\n# Sort imports\nisort src/ tests/\n\n# Type checking\nmypy src/\n\n# Linting\nflake8 src/ tests/\n```\n\n### Pre-commit Hooks\n\n```bash\npre-commit install\npre-commit run --all-files\n```\n\n## Documentation\n\n- [API Reference](https://bssagent.readthedocs.io/en/latest/api/)\n- [User Guide](https://bssagent.readthedocs.io/en/latest/user_guide/)\n- [Developer Guide](https://bssagent.readthedocs.io/en/latest/developer/)\n- [Deployment Guide](https://bssagent.readthedocs.io/en/latest/deployment/)\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\n- Documentation: https://bssagent.readthedocs.io\n- Issues: https://github.com/bssagent/bssagent/issues\n- Discussions: https://github.com/bssagent/bssagent/discussions\n- Email: team@bssagent.com\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for a list of changes and version history. \n",
"bugtrack_url": null,
"license": "MIT",
"summary": "BSS Agent \u2013 A simple AI agent framework based on LangGraph",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/bssagent/bssagent/issues",
"Changelog": "https://github.com/bssagent/bssagent/blob/main/CHANGELOG.md",
"Documentation": "https://bssagent.readthedocs.io",
"Homepage": "https://github.com/bssagent/bssagent",
"Repository": "https://github.com/bssagent/bssagent.git"
},
"split_keywords": [
"ai",
" agent",
" langchain",
" langgraph",
" business",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "82fe1a284067fe7de6df7e5a0a8f8a486839ce7006188cbdd5c4d8560cec0613",
"md5": "ebce1cf4cd3ec0b08752f2f8db26ee64",
"sha256": "66cc2cde13696f1dc386d227709db6d643247e9528f35371908bc6e0240b59de"
},
"downloads": -1,
"filename": "bssagent-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ebce1cf4cd3ec0b08752f2f8db26ee64",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 65917,
"upload_time": "2025-07-31T09:25:38",
"upload_time_iso_8601": "2025-07-31T09:25:38.230785Z",
"url": "https://files.pythonhosted.org/packages/82/fe/1a284067fe7de6df7e5a0a8f8a486839ce7006188cbdd5c4d8560cec0613/bssagent-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f73b49c68fd1f2e54c1de5086f4444815d0fc23d6f9eb18c36242cb7e5f465bc",
"md5": "7411e7cda27e07ad25d9d1a6019c1885",
"sha256": "220c24b69c49350fb446d5ba70e36c479e11e470520ed72e22224e5a71bca193"
},
"downloads": -1,
"filename": "bssagent-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7411e7cda27e07ad25d9d1a6019c1885",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 48227,
"upload_time": "2025-07-31T09:25:40",
"upload_time_iso_8601": "2025-07-31T09:25:40.756298Z",
"url": "https://files.pythonhosted.org/packages/f7/3b/49c68fd1f2e54c1de5086f4444815d0fc23d6f9eb18c36242cb7e5f465bc/bssagent-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-31 09:25:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bssagent",
"github_project": "bssagent",
"github_not_found": true,
"lcname": "bssagent"
}
JSON
