10xscale-agentflow-cli 0.1.5__py3-none-any.whl

10xscale_agentflow_cli-0.1.5.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,5 @@
+10xscale_agentflow_cli-0.1.5.dist-info/METADATA,sha256=fLe6KN06z08rsKbxomc_9-6mh3S0uMxXtJkiZ9ZnXuE,11013
+10xscale_agentflow_cli-0.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+10xscale_agentflow_cli-0.1.5.dist-info/entry_points.txt,sha256=YTjzc1wzoHp3kNRBMLOSKtCNU7RQCAc27ZZdPEDoPYg,58
+10xscale_agentflow_cli-0.1.5.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+10xscale_agentflow_cli-0.1.5.dist-info/RECORD,,

10xscale_agentflow_cli-0.1.5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

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

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

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

@@ -0,0 +1 @@
+