Getting Started

Get up and running with Morphik

1. Sign Up

   On a new tab, navigate to the Morphik website and click the “Get Started” button on the top right.

   
2. Create Application

   Once you have signed up, you will be redirected to the Morphik Cloud dashboard. Click the “Create Application” button to create a new application. Enter your app name and click “Create Application”.

   
3. Copy your credentials

   You should now see your application in the dashboard with “Copy URI” and “Copy Token” buttons:

   • For Python SDK: Click “Copy URI”

   • For TypeScript/API: Click “Copy Token”

     

That’s it! You’re ready to use Morphik now :)

Using Morphik

While most users integrate Morphik into their applications via our SDKs and APIs, we also provide a comprehensive web interface that serves as both a playground and management console.

Morphik Web Interface

The Morphik web interface provides a complete view of your application:

In the web interface, you can:

• 📄 Browse and manage all your documents and folders
• 💬 Use the Chat and Agent for interactive queries and complex tasks
• 🔗 Visualize Knowledge Graphs to understand document relationships
• 📊 Monitor logs and track API usage
• 💳 View billing and usage details for your account
• ⚙️ Configure settings and manage your application

This interface is perfect for testing queries, debugging, and getting familiar with Morphik’s capabilities before integrating it into your code.

Using Morphik via Code

For production use, you’ll want to integrate Morphik using our SDKs or API:

Python SDK

1. Create a virtual environment

   python3.12 -m venv .venv
   
2. Activate the virtual environment

   source .venv/bin/activate
   
3. Install the SDK

   pip install morphik
   
4. Ingest and Query your first file

   from morphik import Morphik
   
   # Initialize the Morphik client
   morphik = Morphik(uri="your-morphik-uri")
   # Ingest a file
   doc = morphik.ingest_file(file_path="super/complex/file.pdf")
   doc.wait_for_completion()
   
   # Query the file
   response = morphik.query(query="What percentage of Morphik users are building something cool?")
   print(response) # Responds with 100% :)
   

You can find our entire SDK documentation here.

TypeScript/JavaScript SDK

1. Install the SDK

   npm install morphik
   # or
   yarn add morphik
   
2. Ingest and Query your first file

   import Morphik from 'morphik';
   import * as fs from 'fs';
   
   // Initialize the Morphik client
   // Copy token from dashboard
   const morphik = new Morphik({
     apiKey: 'your-morphik-token'
   });
   
   // Ingest a file
   const file = fs.createReadStream('super/complex/file.pdf');
   const doc = await morphik.ingest.ingestFile({ file });
   
   // Wait for processing to complete
   await new Promise(resolve => setTimeout(resolve, 5000));
   
   // Query the file
   const response = await morphik.query.generateCompletion({
     query: 'What percentage of Morphik users are building something cool?'
   });
   console.log(response.completion); // Responds with 100% :)
   

You can find our API reference with SDK examples here.

Rest API

1. Extract your bearer token

   The bearer token can be extracted directly from your Morphik URI. The URI has the following format:

   morphik://<app_name>:<bearer_token>@<host>

   The middle part between the colon and the @ symbol is your bearer token.

2. Make API requests

   When making requests to the Morphik API, include your bearer token in the Authorization header:

     curl -X 'POST' 'https://api.morphik.ai/documents?skip=0&limit=10000' \
     -H "Authorization: Bearer <your_bearer_token>"
     -H 'accept: application/json' \
     -H 'Content-Type: application/json' \
     -d '{}'
   

   You can find our complete API reference here.

MCP

You can find more information about MCP here.

Community Support

We have an open community with lots of discussion where you can get help, report bugs, and share your experiences with Morphik. If you need assistance or want to contribute, please join our community!

Join our Discord

Get help, report bugs, and connect with other Morphik users.

Next Steps

Now that you have the server running, you can explore the different ways to interact with the server.

Configure Morphik

Configure Morphik using the morphik.toml file.

API

Use the API to interact with the server.

Python SDK

Use the Python SDK to interact with the server.

TypeScript/JavaScript SDK

Use the TypeScript/JavaScript SDK to interact with the server.