JIVAS Web Server (jvserve)

jvserve is a FastAPI-based web server designed for loading and interacting with JIVAS agents. It is built on top of jac-cloud and provides a robust platform for managing jivas agent jobs, handling webhooks, and executing actions within the JIVAS ecosystem.

Installation

To install jvserve, use pip:

pip install jvserve

Usage

To use jvserve, you can start the server with the following command:

jac jvserve <path_to_your_jac_file>

For example:

jac jvserve main.jac

You can also start a file server to serve static files:

jac jvfileserve <directory>

For example:

jac jvfileserve ./static

Supported Arguments

• filename: Path to your JAC file.
• host: Host address to bind the server (default: localhost).
• port: Port number to bind the server (default: 8000).
• loglevel: Logging level (default: INFO).
• workers: Number of worker processes (optional).

Example with all arguments:

jac jvserve main.jac --host 127.0.0.1 --port 8080 --loglevel DEBUG --workers 4

API Endpoints

• Interact with Agent: /interact (POST)
• Execute Webhook: /webhook/{key} (GET, POST)
• Execute Action Walker: /action/walker (POST)

You can see all endpoints at the URL /docs.

🔰 Contributing

• 🐛 Report Issues: Submit bugs found or log feature requests for the jvserve project.
• 💡 Submit Pull Requests: Review open PRs, and submit your own PRs.

🎗 License

This project is protected under the Apache License 2.0. See LICENSE for more information.

Additional Information

Since jvserve is a wrapper around jac-cloud, it supports all the primitives available in jac-cloud. You can find more information about jac-cloud primitives here.