Skip to main content

Sven CLI client for agent automation

Project description

Sven

Sven is the CLI client for ActiveAgent, providing a command-line interface for interacting with the ActiveAgent server.

Installation

pip install sven

Usage

# Basic usage
aa --help

# Connect to a server
aa connect --url http://localhost:8000

# Run an agent
aa agent run --name my-agent

# List available tools
aa tools list

Development

Setup

# Clone the repository
git clone https://git.swedishembedded.com/core/platform/sven.git
cd sven

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

Testing

pytest

Linting

# Run all linters
pre-commit run --all-files

# Run individual linters
black .
isort .
mypy .
ruff .

CI/CD Pipeline

This project uses GitLab CI/CD for automated testing, building, and deployment. The pipeline includes:

  • Lint: Code quality checks with black, isort, ruff, and mypy
  • Test: Unit and integration tests with pytest
  • Build: Package building with setuptools
  • Publish: Publishing to PyPI (on tags) and TestPyPI (on main branch)

Releasing

We use semantic versioning for this project. To create a new release:

  1. Update the CHANGELOG.md with your changes
  2. Use bump2version to increment the version:
    # For a patch release (0.1.0 -> 0.1.1)
    bump2version patch
    
    # For a minor release (0.1.0 -> 0.2.0)
    bump2version minor
    
    # For a major release (0.1.0 -> 1.0.0)
    bump2version major
    
  3. Push the new tag to trigger the release pipeline:
    git push --tags
    

Contributing

Please see CONTRIBUTING.md for details on how to contribute to this project.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

agent_sven-0.1.0-py3-none-any.whl (35.8 kB view details)

Uploaded Python 3

File details

Details for the file agent_sven-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: agent_sven-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 35.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.7

File hashes

Hashes for agent_sven-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 49cc7b700cbd1228fa5af8e2967b32386589a1c0908528d8d00a16ed96d1b8ee
MD5 a09cf059a168e572a8c8e35d4d5056b4
BLAKE2b-256 051b809ca4959ac93e09feefd233535508558e27b3eba9594340324c4c81e835

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page