weco 0.1.5

A client facing API for interacting with the WeCo AI function builder service.

$f$(👷‍♂️)

A client facing API for interacting with the WeCo AI function builder service!

Use this API to build complex systems fast. We lower the barrier of entry to software engineer, data science and machine learning by providing an interface to prototype difficult solutions quickly in just a few lines of code.

Installation

Install the weco package simply by calling this in your terminal of choice:

pip install weco

Features

• The build function enables quick and easy prototyping of new functions via LLMs through just natural language. We encourage users to do this through our web console for maximum control and ease of use, however, you can also do this through our API as shown in here.
• The query function allows you to test and use the newly created function in your own code.
• We offer asynchronous versions of the above clients.
• We provide a batch_query functions that allows users to batch functions for various inputs as well as multiple inputs for the same function in a query. This is helpful to make a large number of queries more efficiently.
• We also offer multimodality capabilities. You can now query our client with both language AND vision inputs!

We provide both services in two ways:

• weco.WecoAI client to be used when you want to maintain the same client service across a portion of code. This is better for dense service usage.
• weco.query and weco.build to be used when you only require sparse usage.

Usage

When using the WeCo API, you will need to set the API key: You can find/setup your API key here by navigating to the API key tab. Once you have your API key, you may pass it to the weco client using the api_key argument input or set it as an environment variable such as:

export WECO_API_KEY=<YOUR_WECO_API_KEY>

Example

We create a function on the web console for the following task:

"Analyze a business idea and provide a structured evaluation. Output a JSON with 'viability_score' (0-100), 'strengths' (list), 'weaknesses' (list), and 'next_steps' (list)."

Now, you're ready to query this function anywhere in your code!

from weco import query
response = query(
    fn_name="BusinessIdeaAnalyzer-XYZ123",  # Replace with your actual function name
    text_input="A subscription service for personalized, AI-generated bedtime stories for children."
)

For more examples and an advanced user guide, check out our function builder cookbook.

Happy building $f$(👷‍♂️)!

Contributing

We value your contributions! If you believe you can help to improve our package enabling people to build AI with AI, please contribute!

Use the following steps as a guideline to help you make contributions:

1. Download and install package from source:

   git clone https://github.com/WecoAI/weco-python.git
   cd weco-python
   pip install -e ".[dev]"
   

2. Create a new branch for your feature or bugfix:

   git checkout -b feature/your-feature-name
   

3. Make your changes and run tests to ensure everything is working:

   Tests can be expensive to run as they make LLM requests with the API key being used so it is the developers best interests to write small and simple tests that adds coverage for a large portion of the package.

   pytest -n auto tests
   

4. Commit and push your changes, then open a PR for us to view 😁

Please ensure your code follows our style guidelines (Numpy docstrings) and includes appropriate tests. We appreciate your contributions!