Merge branch 'kagisearch:main' into main

kagisearch · Jan 30, 2024 · 1f9d0ff · 1f9d0ff
2 parents efc9ae6 + 0bcfbc7
commit 1f9d0ff
Show file tree

Hide file tree

Showing 29 changed files with 138 additions and 74 deletions.
diff --git a/docs/common/company/hiring-kagi.md b/docs/common/company/hiring-kagi.md
@@ -8,11 +8,13 @@ next:
 ## Full-time positions
 
 **Core Back-end Team**
-- Advanced knowledge of the Crystal language.
+- Advanced knowledge of the Crystal language. 
 - Exceptional problem-solving and coding abilities.
 - Crafting products with care
 
-**Core Front-end Team**
+Our tech lead Zac Nowicki recently gave a talk at Crystal Conf. Zac shares a summary of lessons, technology, ideas, and challenges after building a search engine product from the ground up in Crystal for the past three years. Watch the presentation [here](https://www.youtube.com/watch?v=r7t9xPajjTM&list=PLt-CsM4G1WoadONHl3zPN_Ts5PqH8TgMZ&index=8).
+
+**Core Front-end Team** (we are currently full, check back later)
 - Passion for creating delightful and swift user interfaces. 
 - Proficiency in HTML, CSS, and an understanding that JavaScript can be used sparingly to enhance, not create, product experiences.
 - You are comfortable not using any FE frameworks, and rather like to be in full control of the DOM and as close to browser as possible.
@@ -33,16 +35,14 @@ Fun fact: At Kagi, we [prioritize speed](https://help.kagi.com/kagi/search-detai
 - Flexible working conditions; remote first culture.
 - Our journey is filled with exciting challenges and ever-evolving processes. It's a bit of a rollercoaster, not for the feign-hearted.
 - Our ambition is enormous, going against industry giants with a very small team. You will work a lot.
-- We are completely user funded. Kagi is currently in [one village worth of homes](https://kagi.com/stats). Do not expect VC backed/big-tech salary. Do expect equity as a part of compensation.
+- We are completely user funded. Kagi is currently used by [one town worth of people](https://kagi.com/stats). Do not expect VC backed/big-tech salary. Do expect equity as a part of compensation.
 
 Send your CV to [[email protected]](mailto:[email protected]).  We’ll send a test project.
 
 ## Part-time opportunities
 
 **Kagi R&D Team** (aka Kagi Labs)
 
-**Note:** We are currently full, please check back later.
-
 We are deeply committed to fostering a culture of research and development (R&D) at Kagi. Many of our groundbreaking technologies such as the [Universal Summarizer](https://kagi.com/summarizer), [FastGPT](https://kagi.com/fastgpt) or [Small Web](https://kagi.com/smallweb) have their origins in our R&D initiatives. At any time we have 4-5 individuals working on R&D projects, with some eventually transitioning to full-time roles.
 
 We are currently seeking full-stack developers who embody the following qualifications:
@@ -56,3 +56,10 @@ We are currently seeking full-stack developers who embody the following qualific
 If you are eager to contribute to cutting-edge projects and grow with a dynamic team, we would be thrilled to hear from you.
 
 Send your CV to [[email protected]](mailto:[email protected]).  We’ll send a test project.
+
+## Who you would be working with
+
+To get a sense of some aspects of the position, including the team you would be working with and the business itself, check out the [Kagi Search community event](https://www.youtube.com/watch?v=DRVY-74lkBA), recorded live in December 2023 in [Kagi discord](https://kagi.com/discord).
+
+<a href=
+"https://www.youtube.com/watch?v=DRVY-74lkBA"><img width="400" alt="Kagi community event" src="https://github.com/kagisearch/kagi-docs/assets/4319401/d5aa73a0-871b-40a0-b92d-e135f5cc552a"></a>
diff --git a/docs/common/company/hiring-orion.md b/docs/common/company/hiring-orion.md
@@ -51,3 +51,12 @@ AppKit or UIKit に精通しており、難しい問題を解決できる
 
 - 現在、日本に支社はございません。
 - 候補者様とのやりとり、面接、コミュニケーションなどにおいて使用される言語は英語のみとなります。
+
+
+## Who you would be working with
+
+To get a sense of some aspects of the position, including the team you would be working with and the work itself, check out the [Orion Browser community event](https://www.youtube.com/watch?v=824jsH9mxzQ), recorded live in December 2023 in [Orion discord](https://discord.com/invite/gKh5E6ys6D).
+
+<a href=
+"https://www.youtube.com/watch?v=824jsH9mxzQ"><img width="400" alt="Kagi community event" src="https://github.com/kagisearch/kagi-docs/assets/4319401/d3c2d5db-cc56-4271-8374-aea21ef886e0"></a>
+
diff --git a/docs/common/company/history.md b/docs/common/company/history.md
@@ -44,3 +44,5 @@ First prototype of Orion browser with support for web extensions on iOS is made,
 - [Kagi raises $670K](https://blog.kagi.com/safe-round) from its users in its first external fundraise. Total money invested nears $5M at this point.
 - We publish our [live stats](https://kagi.com/stats)
 - We cross $1M annual revenue milestone, offering paid web search and paid web browser product
+- Kagi Assistant enters public beta 
+- The team is now ~30
diff --git a/docs/common/company/index.md b/docs/common/company/index.md
@@ -8,7 +8,7 @@ next:
 
 Kagi Inc. is a company created with the mission to humanize the web. Our goal is to amplify the web of human knowledge, creativity, and self-expression.
 
-Kagi was founded in 2018 by [Vladimir Prelovac](https://vladimir.prelovac.com/) in Palo Alto, CA (USA). Kagi's advisory board consists of [Raghu Murthi](https://www.linkedin.com/in/raghumurthi) and [Dr. Norman Winarsky](https://en.wikipedia.org/wiki/Norman_Winarsky). Our team is a fully remote team operating on all continents.
+Kagi was founded in 2018 by [Vladimir Prelovac](https://vladimir.prelovac.com/) in Palo Alto, CA (USA). Kagi's advisory board consists of [Raghu Murthi](https://www.linkedin.com/in/raghumurthi), [Dr. Norman Winarsky](https://en.wikipedia.org/wiki/Norman_Winarsky) and [Stephen Wolfram](https://en.wikipedia.org/wiki/Stephen_Wolfram). Our team is a fully remote team operating on all continents.
 
 Kagi has been bootstrapped by the founder from 2018 to 2023. In 2023, [Kagi raised $670K](https://blog.kagi.com/safe-round) from Kagi members in its first external fundraise.
 

diff --git a/docs/kagi/ai/assistant.md b/docs/kagi/ai/assistant.md
@@ -2,13 +2,15 @@
 
 Kagi Assistant is a product feature backed by Kagi Search and large language models.
 
-> Kagi Assistant is currently in closed beta only available to Ultimate plan members.
+> Kagi Assistant is currently in open beta only available to Ultimate plan members.
 
 ## Assistant Modes
 
 ### Research
 
 Research assistant uses Kagi search and external sources like Wolfram Alpha, together with an AI model to answer your queries.
+This model also allows you to upload a file (up to 8 MB) or provide a URL (article, PDF, video, podcast, etc.) to use as context.
+If an image is provided it will be processed using GPT4 Vision.
 
 ![Kagi Assistant - Research](./media/assistant_research.png){width=500px data-zoomable}
 
@@ -42,9 +44,8 @@ This mode supports the following models:
 - Anthropic
   - `claude-instant`
   - `claude-2` (for Ultimate members)
-- Google
-  - `chat-bison`
-  - `code-bison` (Codey)
+- Mistral AI
+  - `mistral-medium` (for Ultimate members)
 
 Access directly with the `!chat` bang.
 
@@ -57,3 +58,12 @@ Custom assistant allows you to further customize one of the existing modes.
 Select the base mode (and variant/model where applicable) and add your own custom instructions. Setup is detailed in the [Assistant settings help page](../settings/assistant.md#custom-assistant).
 
 Access directly with the `!custom` bang.
+
+## Tips and Tricks for using Kagi Assistant
+
+- Assistant has a character limit of 6,000 for each prompt in a conversation.
+- You can input math equations using the LaTeX format.
+- Using the copy button will copy the response to your clipboard preserving any formatting using markdown.
+- Assistant supports syntax highlighting in generated code snippets.
+- For optimal results, interact with the Assistant in a natural language. For instance, "Who was Alan Turing?" will yield a better response than simply "Alan Turing".
+- When using Code Assistant, it is recommended to specify the programming language you are using as part of your prompt.
diff --git a/docs/kagi/api/search.md b/docs/kagi/api/search.md
@@ -2,8 +2,10 @@
 
 The Search API gives programmable access to Kagi's premium search results.
 
-> **NOTE:** The Search API is currently only available to customers of the
-> Kagi Teams plan. Please reach out to [email protected] for invite.
+> **NOTE:** The Search API is in closed beta and is currently available to Kagi Business (Team) plan.
+> This is currently $19/mo plus search API cost (2.5c per search). Please reach out to [email protected] for invite.
+>
+> We plan to release this API to all Kagi members after the beta period.
 
 
 ## Quick start

diff --git a/docs/kagi/api/summarizer.md b/docs/kagi/api/summarizer.md
@@ -1,25 +1,26 @@
 # Universal Summarizer
 
-The Universal Summarizer is an API using powerful LLMs to summarize content on the web, or your own documents, of any length.
+The Universal Summarizer is an API using powerful LLMs to summarize any content, of almost any format, with unlimited token length!
 
 ## Quick start
 
 
 1. Get the [API key](https://kagi.com/settings?p=api) (requires a Kagi account)
 2. Top off your [API credits](https://kagi.com/settings?p=billing_api).
 3. Call the API. See [example usage](#examples).
+4. Alternatively use Kagi Search browser extension ([Chrome](https://chromewebstore.google.com/detail/kagi-search-for-chrome/cdglnehniifkbagbbombnjghhcihifij?pli=1)/[Firefox](https://addons.mozilla.org/en-US/firefox/addon/kagi-search-for-firefox/)) and you can use the most advanced Muriel model right from the extension.
 
 ## API key
 
-To obtain an API key you will first need to [create a Kagi account](https://kagi.com/signup?plan_id=trial). 
+To obtain an API key you will first need to [create a Kagi account](https://kagi.com/signup?plan_id=trial).
 
 Then, navigate to Settings -> Advanced -> API portal, or click [here](https://kagi.com/settings?p=api) to go directly.
 
 Click "Generate API Token".
 
 ## API credits
 
-Universal Sumamrizer API uses pre-paid API credits. You can manage API credits in the [API billing](https://kagi.com/settings?p=billing_api) page of your Kagi settings.
+Universal Summarizer API uses pre-paid API credits. You can manage API credits in the [API billing](https://kagi.com/settings?p=billing_api) page of your Kagi settings.
 
 Using API with insufficient credits will produce "Insufficient credit to perform this request." response message.
 
@@ -40,7 +41,7 @@ Notes:
 
 Our enterprise-grade Muriel summarization engine produces even higher quality summaries, especially for long documents. It also provides longer and more detailed summaries than our consumer-grade model. See the difference [here](https://blog.kagi.com/universal-summarizer#muriel).
 
-Murial usage is a **flat rate of $1 USD per summary**, regardless of the length or type of the document. 
+Muriel usage is a **flat rate of $1 USD per summary**, regardless of the length or type of the document.
 
 To use Muriel just use "muriel" as the "engine" parameter in the API call. See examples below.
 
@@ -226,7 +227,7 @@ Different summarization engines are provided that will give you choices over the
 Engine | Description
 -------|-----------
 cecil (default) | Friendly, descriptive, fast summary
-agnes  | Formal, technical, analytical summary 
+agnes  | Formal, technical, analytical summary
 daphne | Informal, creative, friendly summary
 muriel | Best-in-class summary using our enterprise-grade model
 
@@ -236,7 +237,7 @@ The summarizer can translate the output into a desired language, using the table
 of supported language codes below.
 
 If no language is specified, the document's original language is allowed to
-influence the summarizer's output. Specifying a language will add a an explicit
+influence the summarizer's output. Specifying a language will add an explicit
 translation step, to translate the summary to the desired language.
 
 For example, if a document is mostly written in Spanish, the summary output may
@@ -275,3 +276,4 @@ SV | Swedish
 TR | Turkish
 UK | Ukrainian
 ZH | Chinese (simplified)
+ZH-HANT | Chinese (traditional)
diff --git a/docs/kagi/community-addons/index.md b/docs/kagi/community-addons/index.md
@@ -46,3 +46,10 @@ Adds a button to the right click context menu on Firefox that allows you to open
 ## Script Kit
 
 - [FastGPT for Script Kit](https://scriptkit.com/api/new?name=kagi-fastgpt&url=https://gist.githubusercontent.com/awakenedhaggis/bd9dbf2421325117f7e5c20f62e1c99f/raw/9ab7d843fdfb2bf3b1e3c65e5c4774fe896abc91/kagi-fastgpt.ts): Access our [FastGPT API](../api/fastgpt.md) directly from your desktop using Script Kit.
+
+## Chrome Extension
+
+[FastGPT to Markdown](https://chromewebstore.google.com/detail/kagi-fastgpt-to-markdown/bamhebecdlhhkedgncapjoofbohgiogc): Copy Kagi FastGPT question and answer to your clipboard, nicely formatted in Markdown.
+
+## Emacs
+- [kagi.el](https://codeberg.org/bram85/kagi.el): Emacs package that provides access to the Kagi FastGPT and Universal Summarizer API.
diff --git a/docs/kagi/faq/faq.md b/docs/kagi/faq/faq.md
@@ -52,7 +52,8 @@
 - [What are the limitations of the Trial plan?](#what-are-the-limitations-of-the-trial-plan)
 - [I'm having issues staying logged in or searching occasionally doesn't work](#i-m-having-issues-staying-logged-in-or-searching-occasionally-doesn-t-work)
 - [Is using Kagi Assistant better in terms of privacy than using one of the LLM models directly?](#is-using-kagi-assistant-better-in-terms-of-privacy-than-using-one-of-the-llm-models-directly)
-- 
+- [Can I use my personal account for work?](#personal-account-for-work)
+- [Do you have a warrant canary?](#warrant-canary)
 
 ## What is Kagi {#what-is-kagi}
 
@@ -322,6 +323,16 @@ Unfortunately, our hosting provider (GCP) is known to block some VPN IP addresse
 The reason is that Google knows where you are (since it tracks you across apps/devices), who you are and your past search history.
 When you search for 'dog and pony' Google may know it is the name of your local pub because you searched for it before, or recorded your location at that place through your phone, while Kagi does not so it shows you animal results instead.
 
+<a name="personal-account-for-work"></a>
+## Can I use my personal account for work? {#personal-account-for-work}
+
+Yes, you can use your individual account for any kind of work.
+However, only you may use your personal account; you may not share it with others.
+
+<a name="warrant-canary"></a>
+## Do you have a warrant canary? {#warrant-canary}
+Yes, our warrant canary is included in our [privacy page](https://kagi.com/privacy#warrant-canary).
+
 ---
 
 If you are experiencing issues, please [open a ticket](https://kagifeedback.org/) with as much detail as possible, and we will review it ASAP.

diff --git a/docs/kagi/features/bangs.md b/docs/kagi/features/bangs.md
@@ -12,7 +12,6 @@ Note that Kagi supports all [DuckDuckGo-style bangs](https://duckduckgo.com/bang
 
 ## Bang Examples
 
-
 Some of the more popular search bangs include:
 
 - **!help** \<query> to search this knowledge base for information about Kagi Search. Try "!help search operators" in Kagi.
@@ -41,20 +40,24 @@ Bang | Region
 -----|-------
 int  | International
 at   | Austria
-be   | Belgium
+be   | Belgium (en)
+be_fr| Belgium (fr)
 bj   | Benin
 by   | Belarus
 bz   | Belize
-ca   | Canada
+ca   | Canada (en)
+ca_fr| Canada (fr)
 cf   | Central African Republic
-ch   | Switzerland
+ch   | Switzerland (de)
+ch_fr| Switzerland (fr)
 cn   | China
 co   | Colombia
 cx   | Christmas Island
 cy   | Cyprus
 de   | Germany
 dk   | Denmark
-es   | Spain
+es   | Spain (es)
+es_ca| Spain (ca)
 fr   | France
 gb   | United Kingdom
 hr   | Croatia
@@ -103,9 +106,11 @@ zm   | Zambia
 
 ### AI related bangs
 
-- **!sum** \<url> - Key moments of the page in [Universal Summarizer](../ai/summarize-page.md)
-- **!sumk** \<url> -  Alias of `!sum`
+- **!sum** \<url> - Summarize the page in [Universal Summarizer](../ai/summarize-page.md) using the default setting (currently key moments)
+- **!sumk** \<url> -  Key moments of the page in [Universal Summarizer](../ai/summarize-page.md)
+- **!summ** \<url> -  Summary of the page in [Universal Summarizer](../ai/summarize-page.md)
 - **!discuss** \<url> - Discuss Document chat
+- **!fast** \<query> - Invoke FastGPT with the query
 - **!quick** \<search terms> - Search & open "Quick Answer"
 
 ### Kagi Assistant bangs
@@ -120,7 +125,6 @@ zm   | Zambia
 
 ### Search on external websites
 
-
 - **!yt** \<query> for [YouTube](https://youtube.com)
 - **!r** \<query> for [Reddit](https://www.reddit.com)
 - **!u** \<query> for [Urban Dictionary](https://www.urbandictionary.com)
@@ -147,7 +151,6 @@ Configure Quick Bangs under [Search](https://kagi.com/settings?p=search) in the
 
 ![Quick Bangs](./media/quick_bangs.png){data-zoomable}
 
-
 ## Custom Bangs
 
 You can also create your own Custom Bangs in [Advanced Settings](https://kagi.com/settings?p=advanced).
@@ -164,7 +167,6 @@ From here you can "Add Bang" to define new custom bangs.
 
 You can create your own Custom Bangs in Kagi using the [Search Shortcuts menu](search-shortcuts.md).
 
-
 ## Watch a Demo
 
 You can see a full demo of using bangs - default, new and custom - by watching the video below.
@@ -185,4 +187,3 @@ Here is the full list of "feeling lucky" patterns that we support:
 - `! query`
 - `query !`
 - `\query`
-
diff --git a/docs/kagi/features/search-operators.md b/docs/kagi/features/search-operators.md
@@ -91,6 +91,8 @@ If you press **?** on your keyboard (**shift + /**) while in search results, Kag
 
 **!m** — [Bang](bangs.md) that performs a Kagi Maps search, for example: [!m eiffel tower](https://kagi.com/search?q=!m%20eiffel%20tower)
 
+**!q** — [Bang](bangs.md) that performs a search with [Quick Answer](https://help.kagi.com/kagi/ai/quick-answer.html) enabled, for example: [!q pythagorean theorem](https://kagi.com/search?q=!q%20pythagorean+theorem)
+
 **calc** — Opens a widget that can perform math calculations, unit conversions, and currency conversions, for example: [calc](https://kagi.com/search?q=calc). The widget opens automatically when you search for a calculation, like [(45 * 2) / (5 + 10)](https://kagi.com/search?q=%2845+*+2%29+%2F+%285+%2B+10%29).
 
 **ip address** — Check your IP address by searching for [ip address](https://kagi.com/search?q=ip%20address)

diff --git a/docs/kagi/getting-started/index.md b/docs/kagi/getting-started/index.md
@@ -18,6 +18,11 @@ Kagi helps you find exactly what you're looking for online. It has a few more ca
 - [Set Kagi as your default search engine](#set-kagi-as-your-default-search-engine)
 - [Kagi member communities](#kagi-member-communities)
 
+## Set Kagi as your default search engine
+
+Learn how to set Kagi as [default search engine in your browser](./setting-default.md), including using private session link to have it work in private browser windows without logging in.
+
+
 ## Personalize Results
 
 Kagi's personalization options lets you customize your results including eliminating websites that you find low quality or distracting or boosting those that you find more useful. Clicking the shield icon to the right of a search result reveals additional information and [personalization options](https://help.kagi.com/kagi/features/website-info-personalized-results.html) for that result. From here you can raise or lower the weighting for that website including blocking websites that you'd like eliminated from your search results. You can see some of the more popular modifications on the [Kagi Personalization Leaderboard](https://kagi.com/stats?stat=leaderboard).
@@ -77,9 +82,6 @@ You can [share your search results](https://help.kagi.com/kagi/features/share-re
 
 <img src="./media/share_this_search.png" width="675" alt="Sharing Search Results"><br />
 
-## Set Kagi as your default search engine
-
-Learn how to set Kagi as [default search engine in your browser](./setting-default.md), including using private session link to have it work in private browser windows without logging in.
 
 ## Kagi member communities