Skip to main content

A lightweight, local-first agent framework for programmatic code execution and orchestration.

Project description

Vanaras AI — Agent Framework

PyPI License

Vanaras AI Agents

Vanaras is a Local First, extensible agent framework for programmatic code tasks, tool execution, and memory-backed context. It provides a minimal planner, a code executor, a memory store (FAISS), and a sandboxed tools layer that agents call to read/write files, run code, and apply patches.

📚 Documentation

Full documentation is available at vanaras.ai (or run locally with npm start in website/).

🚀 Key Features

  • Local First: Designed to run with local LLMs (Ollama/Llama 3.1) by default. Privacy by design.
  • Agentic Workflow: Don't just run scripts—orchestrate Planner, Developer, Critic, and Validator agents.
  • Templates: 9 built-in templates for common use cases (RAG, Web Scraper, ETL, etc.).
  • Memory: Built-in vector memory (FAISS) for long-term context.
  • Dashboard: Real-time UI to monitor agent activities.

🛠️ Installation

pip install vanaras-agent-framework

Configure LLM (Local First)

  1. Install Ollama: ollama.com
  2. Pull Model: ollama pull llama3.1
  3. Run: Vanaras connects to localhost:11434 automatically.

(Optional: Set VANARAS_LLM_URL and VANARAS_API_KEY for OpenAI)

⚡ Quick Start with CLI

The Interactive CLI is the heart of Vanaras. Just type what you want:

vanaras init my_agent
cd my_agent
vanaras run

Example Session:

🤖 Vanaras Agent Framework
💬 How can I help you today?
> Create a stock price tracker for AAPL and GOOGL. Save the report to markdown.

✨ Working on it...
[Planner] Creating plan...
[Developer] Writing code...
[Critic] Reviewing code...
✅ Done!

📖 Tutorials

We have comprehensive, fully agentic tutorials for every template:

  1. Financial Analyst: Build an ETL pipeline.
  2. Web Scraper: Track competitor prices.
  3. Doc Generator: Auto-generate documentation.
  4. RAG Agent: Chat with legal documents.
  5. Code Analyzer: Audit legacy code.
  6. Multi-Agent Crew: Orchestrate a marketing team.
  7. Testing Framework: Auto-generate test suites.
  8. API Client: Generate SDKs from OpenAPI.
  9. CLI App: Build custom CLI tools.

Enterprise Features 🔒

Vanaras Enterprise provides:

  • Security: SSO, RBAC, Audit Logging
  • Scalability: Distributed execution
  • Compliance: SOC 2, GDPR
  • Support: 24/7 SLA

Contact Sales

License

Open Source: Apache 2.0 Enterprise: Proprietary

Community


Made with ❤️ by Vanaras AI

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

vanaras_agent_framework-2.1.0.tar.gz (36.7 kB view details)

Uploaded Source

Built Distribution

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

vanaras_agent_framework-2.1.0-py3-none-any.whl (36.7 kB view details)

Uploaded Python 3

File details

Details for the file vanaras_agent_framework-2.1.0.tar.gz.

File metadata

  • Download URL: vanaras_agent_framework-2.1.0.tar.gz
  • Upload date:
  • Size: 36.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for vanaras_agent_framework-2.1.0.tar.gz
Algorithm Hash digest
SHA256 653a705f7bd6ef2785cc8a7d66ee88e176d120d6a2bd4639ed991827ddbe438c
MD5 77aa3b14af03f608ae5329b8fb912c96
BLAKE2b-256 726f52881cb7a0922c724a548096a167500c07468e092200bfdfdacbf73afddd

See more details on using hashes here.

File details

Details for the file vanaras_agent_framework-2.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for vanaras_agent_framework-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 099da572a16f8c6137b95ea1f3936d40e2b4f12e5cf7d935e4a77b4e691dca72
MD5 a1cb4c44a168a231e97cd811307b37ec
BLAKE2b-256 99c91e01318b1b60a1dc0cd1df9a56e69e1e80198fc53d06284d4f3b7d34e816

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