10xscale-agentflow-cli 0.1.5__tar.gz

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/PKG-INFO

@@ -0,0 +1,458 @@
+Metadata-Version: 2.4
+Name: 10xscale-agentflow-cli
+Version: 0.1.5
+Summary: CLI and API for 10xscale AgentFlow
+Author-email: 10xscale <contact@10xscale.ai>
+Maintainer-email: Shudipto Trafder <shudiptotrafder@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/10xHub/agentflow-cli
+Project-URL: Repository, https://github.com/10xHub/agentflow-cli
+Project-URL: Issues, https://github.com/10xHub/agentflow-cli/issues
+Project-URL: Documentation, https://agentflow-cli.readthedocs.io/
+Keywords: 10xscale AgentFlow,api,fastapi,cli,agentflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: 10xscale-agentflow>=0.4.0
+Requires-Dist: fastapi
+Requires-Dist: gunicorn==23.0.0
+Requires-Dist: orjson
+Requires-Dist: python-multipart==0.0.19
+Requires-Dist: pydantic==2.8.2
+Requires-Dist: pydantic-settings==2.3.4
+Requires-Dist: uvicorn==0.30.1
+Requires-Dist: typer
+Requires-Dist: python-dotenv
+Requires-Dist: PyJWT==2.8.0
+Provides-Extra: sentry
+Requires-Dist: sentry-sdk==2.10.0; extra == "sentry"
+Provides-Extra: firebase
+Requires-Dist: firebase-admin==6.5.0; extra == "firebase"
+Requires-Dist: oauth2client==4.1.3; extra == "firebase"
+Provides-Extra: snowflakekit
+Requires-Dist: snowflakekit; extra == "snowflakekit"
+Provides-Extra: redis
+Requires-Dist: redis==5.0.7; extra == "redis"
+Provides-Extra: gcloud
+Requires-Dist: google-cloud-logging; extra == "gcloud"
+
+
+# AgentFlow CLI
+
+A Python API framework with GraphQL support, task management, and CLI tools for building scalable web applications.
+
+## Installation
+
+### From PyPI (Recommended)
+```bash
+pip install agentflow-cli
+```
+
+### From Source
+```bash
+git clone https://github.com/Iamsdt/agentflow-cli.git
+cd agentflow-cli
+pip install -e .
+```
+
+## Quick Start
+
+1. **Initialize a new project:**
+```bash
+agentflow init
+```
+
+2. **Start the API server with default configuration:**
+```bash
+agentflow api
+```
+
+3. **Start the API server with custom configuration:**
+```bash
+agentflow api --config custom-config.json
+```
+
+4. **Start the API server on different host/port:**
+```bash
+agentflow api --host 127.0.0.1 --port 9000
+```
+
+5. **Generate a Dockerfile for containerization:**
+```bash
+agentflow build
+```
+
+## CLI Commands
+
+The `agentflow` command provides the following subcommands:
+
+### `agentflow api`
+Start the Pyagenity API server.
+
+**Options:**
+- `--config TEXT`: Path to config file (default: agentflow.json)
+- `--host TEXT`: Host to run the API on (default: 0.0.0.0)
+- `--port INTEGER`: Port to run the API on (default: 8000)
+- `--reload/--no-reload`: Enable auto-reload (default: enabled)
+
+**Examples:**
+```bash
+# Start with default configuration
+agentflow api
+
+# Start with custom config file
+agentflow api --config my-config.json
+
+# Start on localhost only, port 9000
+agentflow api --host 127.0.0.1 --port 9000
+
+# Start without auto-reload
+agentflow api --no-reload
+```
+
+### `agentflow init`
+Initialize a new config file with default settings.
+
+**Options:**
+- `--output TEXT`: Output config file path (default: agentflow.json)
+- `--force`: Overwrite existing config file
+
+**Examples:**
+```bash
+# Create default config
+agentflow init
+
+# Create config with custom name
+agentflow init --output custom-config.json
+
+# Overwrite existing config
+agentflow init --force
+```
+
+### `agentflow version`
+Show the CLI version information.
+
+```bash
+agentflow version
+```
+
+### `agentflow build`
+Generate a Dockerfile for the Pyagenity API application.
+
+**Options:**
+- `--output TEXT`: Output Dockerfile path (default: Dockerfile)
+- `--force/--no-force`: Overwrite existing Dockerfile (default: no-force)
+- `--python-version TEXT`: Python version to use (default: 3.11)
+- `--port INTEGER`: Port to expose in the container (default: 8000)
+
+**Examples:**
+```bash
+# Generate default Dockerfile
+agentflow build
+
+# Generate with custom Python version and port
+agentflow build --python-version 3.12 --port 9000
+
+# Overwrite existing Dockerfile
+agentflow build --force
+
+# Generate with custom filename
+agentflow build --output MyDockerfile
+```
+
+**Features:**
+- 🔍 **Automatic requirements.txt detection**: Searches for requirements files in multiple locations
+- ⚠️ **Smart fallback**: If no requirements.txt found, installs agentflow-cli from PyPI
+- 🐳 **Production-ready**: Generates optimized Dockerfile with security best practices
+- 🔧 **Customizable**: Supports custom Python versions, ports, and output paths
+- 🏥 **Health checks**: Includes built-in health check endpoint
+- 👤 **Non-root user**: Runs container as non-root for security
+
+## Configuration
+
+The configuration file (`agentflow.json`) supports the following structure:
+
+```json
+{
+  "app": {
+    "name": "Pyagenity API",
+    "version": "1.0.0",
+    "debug": true
+  },
+  "server": {
+    "host": "0.0.0.0",
+    "port": 8000,
+    "workers": 1
+  },
+  "database": {
+    "url": "sqlite://./agentflowdb"
+  },
+  "redis": {
+    "url": "redis://localhost:6379"
+  }
+}
+```
+
+## File Resolution
+
+The CLI automatically finds your config file in this order:
+1. Absolute path (if provided with `--config`)
+2. Current working directory
+3. Relative to script location (for development)
+4. Package installation directory (fallback)
+
+## Project Structure
+
+```
+agentflow-cli/
+├── pyagenity_api/           # Main package directory
+│   ├── __init__.py         # Package initialization
+│   ├── cli.py              # CLI module
+│   └── src/                # Source code
+│       └── app/            # FastAPI application
+│           ├── main.py     # FastAPI app entry point
+│           ├── core/       # Core functionality
+│           ├── routers/    # API routes
+│           └── tasks/      # Background tasks
+├── graph/                  # Graph implementation
+├── migrations/             # Database migrations
+├── scripts/               # Utility scripts
+├── docs/                  # Documentation
+├── pyproject.toml         # Project configuration
+├── requirements.txt       # Dependencies
+├── Makefile              # Development commands
+├── MANIFEST.in           # Package manifest
+└── README.md             # This file
+```
+
+## Features
+
+- **FastAPI Backend**: High-performance async web framework
+- **GraphQL Support**: Built-in GraphQL API with Strawberry
+- **Task Management**: Background task processing with Taskiq
+- **CLI Tools**: Command-line interface for easy management
+- **Database Integration**: Support for multiple databases via Tortoise ORM
+- **Redis Integration**: Caching and session management
+- **Authentication**: Firebase authentication support
+- **Development Tools**: Pre-commit hooks, linting, testing
+- **Docker Support**: Container deployment ready
+
+## Setup
+
+### Prerequisites
+- Python 3.x
+- pip
+- [Any other prerequisites]
+
+### Installation
+1. Clone the repository:
+    ```bash
+    git clone https://github.com/10XScale-in/backend-base.git
+    ```
+
+2. Create a virtual environment and activate:
+    ```bash
+    python -m venv venv
+    source venv/bin/activate
+    ```
+
+3. Install dependencies:
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+## Database
+
+### Database Configuration
+The database configuration is located in `src/app/db/setup_database.py`.
+
+### Database Migration
+We use Aerich for database migrations. Follow these steps to manage your database:
+
+1. Initialize the database initially:
+    ```bash
+    aerich init -t src.app.db.setup_database.TORTOISE_ORM
+    ```
+
+2. Create initial database schema:
+    ```bash
+    aerich init-db
+    ```
+
+3. Generate migration files:
+    ```bash
+    aerich migrate
+    ```
+
+4. Apply migrations:
+    ```bash
+    aerich upgrade
+    ```
+
+5. Revert migrations (if needed):
+    ```bash
+    aerich downgrade
+    ```
+
+## Running the Application
+
+### Command Line
+To run the FastAPI application using Uvicorn:
+1. Start the application:
+    ```bash
+    uvicorn src.app.main:app --reload
+    ```
+
+2. You can also run the debugger.
+
+### VS Code
+Add the following configuration to your `.vscode/launch.json` file:
+```json
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: FastAPI",
+            "type": "python",
+            "request": "launch",
+            "module": "uvicorn",
+            "args": [
+                "src.app.main:app",
+                "--host",
+                "localhost",
+                "--port",
+                "8880"
+            ],
+            "jinja": true,
+            "justMyCode": true
+        }
+    ]
+}
+```
+Then you can run and debug the application using the VS Code debugger.
+### Run the Broker
+1. Run the taskiq worker
+```taskiq worker src.app.worker:broker -fsd -tp 'src/**/*_tasks.py' --reload
+```
+## Development
+
+### Using the Makefile
+
+The project includes a comprehensive Makefile for development tasks:
+
+```bash
+# Show all available commands
+make help
+
+# Install package in development mode
+make dev-install
+
+# Run tests
+make test
+
+# Test CLI installation
+make test-cli
+
+# Format code
+make format
+
+# Run linting
+make lint
+
+# Run all checks (lint + test)
+make check
+
+# Clean build artifacts
+make clean
+
+# Build package
+make build
+
+# Publish to TestPyPI
+make publish-test
+
+# Publish to PyPI
+make publish
+
+# Complete release workflow
+make release
+```
+
+### Manual Development Setup
+
+If you prefer manual setup:
+
+1. **Clone the repository:**
+    ```bash
+    git clone https://github.com/Iamsdt/agentflow-cli.git
+    cd agentflow-cli
+    ```
+
+2. **Create a virtual environment:**
+    ```bash
+    python -m venv .venv
+    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+    ```
+
+3. **Install in development mode:**
+    ```bash
+    pip install -e .
+    ```
+
+4. **Install development dependencies:**
+    ```bash
+    pip install pytest pytest-cov ruff mypy pre-commit
+    ```
+
+5. **Set up pre-commit hooks:**
+    ```bash
+    pre-commit install
+    ```
+
+### Testing
+
+Run tests using pytest:
+```bash
+pytest src/tests/ -v --cov=pyagenity_api
+```
+
+Or use the Makefile:
+```bash
+make test
+```
+
+### Publishing to PyPI
+
+1. **Test your package locally:**
+    ```bash
+    make test-cli
+    ```
+
+2. **Publish to TestPyPI first:**
+    ```bash
+    make publish-test
+    ```
+
+3. **If everything works, publish to PyPI:**
+    ```bash
+    make publish
+    ```
+
+
+# Resources
+https://keda.sh/
+Get all the fixers
+pytest --fixtures
+https://www.tutorialspoint.com/pytest/pytest_run_tests_in_parallel.html
+

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/SOURCES.txt

@@ -0,0 +1,88 @@
+MANIFEST.in
+README.md
+Task.md
+agentflow.json
+pyproject.toml
+10xscale_agentflow_cli.egg-info/PKG-INFO
+10xscale_agentflow_cli.egg-info/SOURCES.txt
+10xscale_agentflow_cli.egg-info/dependency_links.txt
+10xscale_agentflow_cli.egg-info/entry_points.txt
+10xscale_agentflow_cli.egg-info/not-zip-safe
+10xscale_agentflow_cli.egg-info/requires.txt
+10xscale_agentflow_cli.egg-info/top_level.txt
+agentflow_cli/__init__.py
+agentflow_cli/cli/__init__.py
+agentflow_cli/cli/constants.py
+agentflow_cli/cli/exceptions.py
+agentflow_cli/cli/logger.py
+agentflow_cli/cli/main.py
+agentflow_cli/cli/commands/__init__.py
+agentflow_cli/cli/commands/api.py
+agentflow_cli/cli/commands/build.py
+agentflow_cli/cli/commands/init.py
+agentflow_cli/cli/commands/version.py
+agentflow_cli/cli/core/__init__.py
+agentflow_cli/cli/core/config.py
+agentflow_cli/cli/core/output.py
+agentflow_cli/cli/core/validation.py
+agentflow_cli/cli/templates/__init__.py
+agentflow_cli/cli/templates/defaults.py
+agentflow_cli/src/__init__.py
+agentflow_cli/src/app/__init__.py
+agentflow_cli/src/app/loader.py
+agentflow_cli/src/app/main.py
+agentflow_cli/src/app/worker.py
+agentflow_cli/src/app/core/__init__.py
+agentflow_cli/src/app/core/auth/__init__.py
+agentflow_cli/src/app/core/auth/auth_backend.py
+agentflow_cli/src/app/core/auth/base_auth.py
+agentflow_cli/src/app/core/auth/jwt_auth.py
+agentflow_cli/src/app/core/config/__init__.py
+agentflow_cli/src/app/core/config/graph_config.py
+agentflow_cli/src/app/core/config/sentry_config.py
+agentflow_cli/src/app/core/config/settings.py
+agentflow_cli/src/app/core/config/setup_logs.py
+agentflow_cli/src/app/core/config/setup_middleware.py
+agentflow_cli/src/app/core/config/worker_middleware.py
+agentflow_cli/src/app/core/exceptions/__init__.py
+agentflow_cli/src/app/core/exceptions/general_exception.py
+agentflow_cli/src/app/core/exceptions/handle_errors.py
+agentflow_cli/src/app/core/exceptions/resources_exceptions.py
+agentflow_cli/src/app/core/exceptions/user_exception.py
+agentflow_cli/src/app/routers/__init__.py
+agentflow_cli/src/app/routers/setup_router.py
+agentflow_cli/src/app/routers/checkpointer/__init__.py
+agentflow_cli/src/app/routers/checkpointer/router.py
+agentflow_cli/src/app/routers/checkpointer/schemas/__init__.py
+agentflow_cli/src/app/routers/checkpointer/schemas/checkpointer_schemas.py
+agentflow_cli/src/app/routers/checkpointer/services/__init__.py
+agentflow_cli/src/app/routers/checkpointer/services/checkpointer_service.py
+agentflow_cli/src/app/routers/graph/__init__.py
+agentflow_cli/src/app/routers/graph/router.py
+agentflow_cli/src/app/routers/graph/schemas/__init__.py
+agentflow_cli/src/app/routers/graph/schemas/graph_schemas.py
+agentflow_cli/src/app/routers/graph/services/__init__.py
+agentflow_cli/src/app/routers/graph/services/graph_service.py
+agentflow_cli/src/app/routers/ping/__init__.py
+agentflow_cli/src/app/routers/ping/router.py
+agentflow_cli/src/app/routers/store/__init__.py
+agentflow_cli/src/app/routers/store/router.py
+agentflow_cli/src/app/routers/store/schemas/__init__.py
+agentflow_cli/src/app/routers/store/schemas/store_schemas.py
+agentflow_cli/src/app/routers/store/services/__init__.py
+agentflow_cli/src/app/routers/store/services/store_service.py
+agentflow_cli/src/app/tasks/__init__.py
+agentflow_cli/src/app/tasks/user_tasks.py
+agentflow_cli/src/app/utils/__init__.py
+agentflow_cli/src/app/utils/callable_helper.py
+agentflow_cli/src/app/utils/parse_output.py
+agentflow_cli/src/app/utils/response_helper.py
+agentflow_cli/src/app/utils/snowflake_id_generator.py
+agentflow_cli/src/app/utils/swagger_helper.py
+agentflow_cli/src/app/utils/schemas/__init__.py
+agentflow_cli/src/app/utils/schemas/output_schemas.py
+agentflow_cli/src/app/utils/schemas/user_schemas.py
+graph/__init__.py
+graph/react.py
+scripts/generate_docs.py
+tests/test_utils_parse_and_callable.py

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentflow = agentflow_cli.cli.main:main

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/requires.txt

@@ -0,0 +1,27 @@
+10xscale-agentflow>=0.4.0
+fastapi
+gunicorn==23.0.0
+orjson
+python-multipart==0.0.19
+pydantic==2.8.2
+pydantic-settings==2.3.4
+uvicorn==0.30.1
+typer
+python-dotenv
+PyJWT==2.8.0
+
+[firebase]
+firebase-admin==6.5.0
+oauth2client==4.1.3
+
+[gcloud]
+google-cloud-logging
+
+[redis]
+redis==5.0.7
+
+[sentry]
+sentry-sdk==2.10.0
+
+[snowflakekit]
+snowflakekit

10xscale_agentflow_cli-0.1.5/10xscale_agentflow_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+

10xscale_agentflow_cli-0.1.5/MANIFEST.in

@@ -0,0 +1,16 @@
+include agentflow.json
+include *.md
+include LICENSE*
+include requirements.txt
+include example_weather_agent.py
+recursive-include agentflow_cli *.json
+recursive-include agentflow_cli *.yaml
+recursive-include agentflow_cli *.yml
+recursive-include agentflow_cli *.py
+recursive-include src *.json
+recursive-include src *.yaml
+recursive-include src *.yml
+recursive-include graph *.py
+recursive-include graph *.json
+recursive-include migrations *.py
+recursive-include scripts *.py