Skip to main content

Adaptive Agentic AI Reasoning That Empower, Inform, and Integrate Seamlessly

Project description

AgenticFleet

Codacy Badge

AgenticFleet is an Adaptative Agentic System that leverages Chainlit for the frontend interface and FastAPI for the backend, built on the foundation of Autogen & Magentic-One.

https://github.com/user-attachments/assets/e36b215a-4fac-4b2a-95e2-90ce7701f277

Quick Links

Features

  • Interactive Chainlit 2.0 chat interface
  • FastAPI backend with structured logging and WebSocket support
  • General Multi-tasking Agentic System based on Magentic-One
  • Advanced prompt engineering with PromptFleet templates
  • Dataset and prompt fabric tools for AI training
  • Comprehensive error handling and connection management
  • Environment-based configuration
  • Extensible architecture for future enhancements

Installation

From PyPI

Recommanded : create a virtual environment using uv:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

The simplest way to install AgenticFleet is via pip:

pip install agentic-fleet

Copy the example environment file and update it with your settings:

cp .env.example .env

Then, you can run the application using the chainlit command:

chainlit run src/app/app.py

From Source

  1. Clone the repository:
git clone https://github.com/qredence/agenticfleet.git
cd agenticfleet
  1. Create and activate a virtual environment using uv:
uv venv
. .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. Install dependencies:

Additional dependencies may be required for certain features. For example, to install Playwright dependencies:

sudo playwright install-deps
sudo apt install -y nodejs npm
npx playwright install-deps

Roadmap (short-term)

Current Progress:

  • Implement core multi-agent architecture
  • Add Multi-modal Surfer agent
  • Add FileSurfer agent
  • Integrate Chainlit 2.0 frontend
  • Add OAuth authentication support
  • Implement real-time streaming responses
  • Add CogCache integration

Short-term Goals:

  • Add Composio Agent
  • Implement LLM model auto-selection
  • Enhance agent coordination
  • Add message persistence
  • Improve file handling capabilities
  • Release AgenticFabric
  • Implement GraphFleet integration
  • Develop AI training tools

Mid-term Goals:

  • Launch cloud service with OAuth + Freetier
  • Create comprehensive prompt engineering suite
  • Build enterprise deployment options
  • Establish agent marketplace
  • Enable cross-platform interoperability
  • Enhance UI/UX features
  • Implement advanced monitoring
  • Add automated error recovery

Prerequisites

  • Python 3.10 or later
  • uv package manager
  1. Configure environment variables:

Copy the example environment file and update it with your settings:

cp .env.example .env

The .env file contains all necessary configuration for both backend and frontend:

  • Azure Services configuration (OpenAI, Key Vault, etc.)
  • External AI Services API keys
  • Backend server settings
  • Frontend (Chainlit) configuration

Development

To start the application in development mode:

# Ensure you're in the virtual environment
. .venv/bin/activate

# Start the Chainlit application
chainlit run src/app/app.py

This will:

  • Launch the Chainlit interface at http://localhost:8001
  • Enable real-time agent communication
  • Provide colored logging output
  • Handle graceful shutdown

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Please ensure your PR:

  • Includes appropriate tests
  • Updates documentation as needed
  • Follows the existing code style
  • Includes proper error handling
  • Has meaningful commit messages

Citation

@misc{fourney2024magenticonegeneralistmultiagentsolving,
    title={Magentic-One: A Generalist Multi-Agent System for Solving Complex Tasks},
    author={Adam Fourney and Gagan Bansal and Hussein Mozannar and Cheng Tan and Eduardo Salinas 
            and Erkang and Zhu and Friederike Niedtner and Grace Proebsting and Griffin Bassman 
            and Jack Gerrits and Jacob Alber and Peter Chang and Ricky Loynd and Robert West 
            and Victor Dibia and Ahmed Awadallah and Ece Kamar and Rafah Hosn and Saleema Amershi},
    year={2024},
    eprint={2411.04468},
    archivePrefix={arXiv},
    primaryClass={cs.AI},
    url={https://arxiv.org/abs/2411.04468}
}

For more information about Autogen, visit their documentation.

License

This project is licensed under the Apache 2.0 License.

Star History

Star History Chart

Project details


Download files

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

Source Distribution

agentic_fleet-0.4.20.tar.gz (299.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentic_fleet-0.4.20-py3-none-any.whl (77.4 kB view details)

Uploaded Python 3

File details

Details for the file agentic_fleet-0.4.20.tar.gz.

File metadata

  • Download URL: agentic_fleet-0.4.20.tar.gz
  • Upload date:
  • Size: 299.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.5.16

File hashes

Hashes for agentic_fleet-0.4.20.tar.gz
Algorithm Hash digest
SHA256 b976e3a66f5a8dabc466e5dbafaeb279bd10133c3e667bf473defa5f5432cd4b
MD5 7106e3526631ab21a291ddcf7840206d
BLAKE2b-256 f65f9d05eb923497c6a5d9650a2fca731c5da55d0c2f1c67930c6c687481ff21

See more details on using hashes here.

File details

Details for the file agentic_fleet-0.4.20-py3-none-any.whl.

File metadata

File hashes

Hashes for agentic_fleet-0.4.20-py3-none-any.whl
Algorithm Hash digest
SHA256 fa6de6127c5b6c90a6a243e4cd3ad675ccee2662503a3ff2511c5eb55296e802
MD5 66a7be22860f677f9aba7427ca9d458c
BLAKE2b-256 68ac002aeec5d8a4618de2dec487bcf1ed8536410500a036aec55757147e83c9

See more details on using hashes here.

Supported by

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