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.0.1.tar.gz (40.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.0.1-py3-none-any.whl (40.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vanaras_agent_framework-2.0.1.tar.gz
  • Upload date:
  • Size: 40.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.0.1.tar.gz
Algorithm Hash digest
SHA256 750b9f6bd740e501862d13109849f52a969dc79c6a8522bf8f62d0f1ad02eae6
MD5 bf251bad51f4d06f921a13d342e9b2ac
BLAKE2b-256 164d24ac4a3b5fbb918151cf020a93a2a05d4d528fa07d990966df5f2af6cfcc

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for vanaras_agent_framework-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f2c32c70702913aef4566acaaab5050e1a759989b756fdb157286c0ee7013a18
MD5 bf4da7ac8b872053742db868a8a527fb
BLAKE2b-256 12d668682b849ef6d4ef7ef9388751221ef74d9e9cd72f7c7c280e7344797f1a

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