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

Uploaded Python 3

File details

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

File metadata

  • Download URL: vanaras_agent_framework-2.0.2.tar.gz
  • Upload date:
  • Size: 40.8 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.2.tar.gz
Algorithm Hash digest
SHA256 c183a36dba20d49da07517c55b0c883c7928223b261f8ae39add6bd1d834ca06
MD5 129b36f42cad8eaf28e66df611eff388
BLAKE2b-256 f7cb377f74c995021ce05101f2178f7fa51bb912da4d005271c9c96fb1ced148

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for vanaras_agent_framework-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 da933deb95645409c860352e62a72cd85546fae1c50084d56c3ef13672a84a8a
MD5 4088a34ef6d7af43321899e299aed01f
BLAKE2b-256 e29e0f4ee5fdeeaf9b36a00a58cc84cd9e8ebe51f1fceb05c312b4803d9cedf9

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