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.21.tar.gz (300.0 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.21-py3-none-any.whl (77.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for agentic_fleet-0.4.21.tar.gz
Algorithm Hash digest
SHA256 d621e1e93af668f4324d2e06a3190ea5357b945119e365cffab0230433391d43
MD5 a99923a87e11c7dc8cbb9ecdef081488
BLAKE2b-256 be528e3a9ae4de3c13e9c82e82e2618cacb46ad5b3ecddd20a6e4fd933d61b72

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agentic_fleet-0.4.21-py3-none-any.whl
Algorithm Hash digest
SHA256 13f5a8465802812f5bf1b18e6fb58203a989cc3d76c947e87ad2b70f46d62254
MD5 f53462e04f3f7050733de9cb6d2e4efe
BLAKE2b-256 b03bbc4d0efe1804841a9e138e9c1fe7d3db9b6cb5dae4dd9260d92ef2aab9b0

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