Metadata-Version: 2.1
Name: mlrequest
Version: 1.0.0
Summary: Python client for the mlrequest machine learning API.
Home-page: https://github.com/mlrequest/mlrequest-python
Author: Mathieu Rodrigue
Author-email: support@mlrequest.com
License: UNKNOWN
Description: # Getting started
        mlrequest-python is a Python client for the [mlrequest](https://mlrequest.com) machine learning API. The client allows you to do a few significant things with only a few lines of code.
        
        * Deploy a latency-routed model to 5 data centers around the world, providing < 60ms global response time and automatic failover. No servers required.
        * Train a model with thousands of training examples per second
        * Get thousands of model predictions per second
        * Create online learning models (models that update incrementally, in real-time). Choose from classification, regression, and reinforcement learning model types.
        
        You will need an API key to get started with mlrequest-python. You can obtain one for free that provides 10,000 model transactions at https://mlrequest.com/signup.html. The free plan is rate limited, for high throughput see our paid plans at https://mlrequest.com/pricing.html. Check out our [documentation](https://docs.mlrequest.com) for more information.
        
        ## Install
        ```
        pip install mlrequest
        ```
        ## Create a Model
        Models are created automatically by calling one of the model endpoints below.
        
        ## Classifier
        ```python
        from mlrequest import Classifier
        classifier = Classifier('your-api-key')
        
        # Learn single
        training_data = {features: {'feature1': 23.1, 'feature2': 'some-value'}, 'label': 1}
        # Learn batch
        training_data = [{features: {'feature1': 23.1, 'feature2': 'some-value'}, 'label': 1}, ...]
        
        r = classifier.learn(training_data=training_data, model_name='my-model', class_count=2)
        r.content # A single response or list of responses
        
        # Predict single
        features = {'feature1': 23.1, 'feature2': 'some-value'}
        # Predict batch
        features = [{'feature1': 23.1, 'feature2': 'some-value'}, ...]
        
        r = classifier.predict(features=features, model_name='my-model', class_count=2)
        r.predict_result # A single predicted class or a list of predicted classes
        ```
        
        ## Regression
        ```python
        from mlrequest import Regression
        regression = Regression('your-api-key')
        
        # Learn single
        training_data = {features: {'feature1': 23.1, 'feature2': 'some-value'}, 'label': 1.25}
        # Learn batch
        training_data = [{features: {'feature1': 23.1, 'feature2': 'some-value'}, 'label': 1.25}, ...]
        
        r = regression.learn(training_data=training_data, model_name='my-model')
        r.content # A single response or list of responses
        
        # Predict single
        features = {'feature1': 23.1, 'feature2': 'some-value'}
        # Predict batch
        features = [{'feature1': 23.1, 'feature2': 'some-value'}, ...]
        
        r = regression.predict(features=features, model_name='my-model')
        r.predict_result # A single predicted value or a list of predicted values
        ```
        
        ## Reinforcement Learning
        ```python
        from mlrequest import RL
        rl = RL('your-api-key')
        
        # Predict
        # Note: epsilon, and action_list fields are optional - see the docs at https://docs.mlrequest.com for more information
        features = {'feature1': 23.1, 'feature2': 'some-value'}
        
        r = rl.predict(features=features, model_name='my-model', session_id='some-session-id', negative_reward=0, action_count=2)
        r.predict_result # A list of actions, ordered by rank (choose r.predict_data[0] for the best action)
        
        # Reward - important note: only the first action from predict_data should be rewarded. Other actions can be used but should not be rewarded.
        r = rl.reward(model_name=model_name, session_id='some_session', reward=1)
        r.content # A single response
        ```
        
        ## Account
        ```python
        # Get account information
        r = account.get_details()
        r.content # Account info response
        
        # Delete a model
        r = account.delete_model(model_name='some-model')
        r.content # Delete success response
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
