falconai 0.0.1

No project description provided

FalconAI

FalconAI is a Python library that simplifies generative AI app creation with access to 10,000+ models, multiple input formats, access to the latest information through the internet and support for text and voice outputs.

Note: This is an alpha release

About

Welcome to FalconAI, the ultimate Python library for creating generative AI applications with ease. FalconAI is designed to minimize development time, maximize performance, and provide unparalleled flexibility. Whether you're building a chatbot, summarizing documents, generating text-based analyses, or integrating voice-based AI outputs, FalconAI empowers you to succeed.

FalconAI handles complex AI interactions with simplicity. By enabling developers to interact with over 10,000 Large Language Models (LLMs) from top providers, supporting multiple input file formats, accessing the latest information through the internet, and delivering results in both text and voice, FalconAI streamlines the development of generative AI solutions to a single line of code.

FalconAI also supports browser automation, allowing real-time interaction with websites for tasks like browsing, data extraction, and dynamic content summarization using LLMs. Additionally, it offers built-in support for MCP (Model Context Protocol), enabling advanced agent-based workflows that can control external applications, perform complex tasks across different environments, and enhance automation with minimal effort.

Installation :

pip install falconai

Linux users, use :
sudo apt update && sudo apt install espeak ffmpeg libespeak1

If you get installation errors , make sure you first upgrade your wheel version using :
pip install --upgrade wheel

Features

Simplified Development

FalconAI reduces development complexity, allowing you to focus on building applications instead of managing APIs, processing files, or integrating multiple providers.

Extensive Model Support

Use over 10,000+ LLMs from top AI providers, including:

• OpenAI
• Gemini
• Claude
• AWS Bedrock
• Mistral
• Hugging Face
• NVIDIA NeMo
• xAI
• Cerebras
• LM Studio
• Groq
• GitHub Models

Multi-format Input

Work seamlessly with a variety of input formats:

• Document: .docx
• PDF: .pdf
• Text: .txt
• Web Content: .html
• Markdown: .md
• Websites: url of the website(s)
• Jupyter Notebook: .ipynb
• Image: url/image location
• CSV: .csv

Flexible Output

FalconAI offers flexibility in how results are returned:

• Text Output: Standard, formatted text responses for integration with websites, applications, or reports.
• Voice Output: Convert AI-generated text to speech, providing an interactive, accessible experience for users with speech-enabled devices or applications.

Web Search Integration

FalconAI supports web search functionality even for LLMs that do not natively support it. This feature enhances the capabilities of models by enabling them to fetch and process the latest information from the web, ensuring your AI applications stay up-to-date and relevant.

One-Line Of Code (Core Logic)

With FalconAI, you can easily create powerful generative AI applications using simple one-liner function calls. Whether you're summarizing a document, building a chatbot, or generating personalized content, FalconAI provides a smooth and simple interface. Here’s an example of how you can start generating text from a document:

from falconai import ai
import os 

os.environ["GEMINI_API_KEY"] = "your-api-key"

output = ai.chat(document="example.docx", model="gemini/gemini-2.5-flash-preview-05-20", prompt="Summarize the content of this document.")
print(output)

Browser Automation

FalconAI supports browser-based automation when browser=True is passed.

Highlights:

• Headless and full browser support via Chromium
• User interaction simulated through controller
• Only supported with models from:
  • OpenAI
  • Google
  • Anthropic
  • GitHub
  • X AI
  • DeepSeek
  • Groq

Example Use Case:

• Extract live content
• Simulate user input
• Validate AI-generated actions in real browser context

Implementation Note: Uses asynchronous control loop with a controller-agent-browser pattern to simulate agentic behavior on real websites.

from falconai import ai
import os

os.environ["GROQ_API_KEY"] = "your-api-key"

output = ai.chat(
    prompt="Search the latest news about OpenAI and summarize it.",
    model="groq/llama3-8b-81924",
    browser=True,
)

print(output)

MCP Agent Support

FalconAI supports advanced multi-context agent functionality with MCP (Model Context Protocol) when mcp=True.

Highlights:

• Launch one or more MCP servers (built-in or custom)
• Supports a wide range of agent tasks including:
  • Text editing
  • PowerPoint/Excel/Word automation
  • Hacker News browsing
  • Web research
  • Docker & WSL system interaction

Built-in MCP Servers:

• desktop-commander
• biomcp
• word-document-server
• puppeteer
• blender
• hackernews
• sequential-thinking
• fetch
• ppt
• airbnb
• app-insight-mcp
• excel
• youtube-transcript
• textEditor
• memory
• mcp-docker
• mcp-wsl
• mcp-compass
• ddg-search
• calculator
• webresearch

Modes:

• Single Prompt Mode: Execute a one-time agent task.
• Chat Mode: Enter continuous interactive conversation with the MCP agent. Type \exit, \quit, or \q to quit.

Custom MCP Server Support:

You can pass:

• A Python dictionary with a "mcpServers" key
• A JSON string with the same structure
• A path to a local JSON file containing server configurations

from falconai import ai
import os

os.environ["TOGETHERAI_API_KEY"] = "your-api-key"

output = ai.chat(
    prompt="Create a PowerPoint presentation about climate change and save it in my cwd. Name it climate_change_ai.pptx",
    model="together_ai/deepseek-ai/DeepSeek-V3",
    MCP=True,
    MCP_builtin_server="ppt",
)

print(output)

Suggestions and feedback

For any suggestion and feedback email me. Full fledged documentation is being prepared. Stay tuned!

License

This project is licensed under the MIT License.